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Preface 


This publication lists the job control tasks needed to enter jobs into the operating system, 
control the system’s processing of jobs, and request the resources needed to run jobs. To 
perform the tasks, programmers code job control statements. This publication describes how to 
code these statements, which consist of: 


e Job control language (JCL) statements 
e Job entry subsystem 2 (JES2) control statements 
e Job entry subsystem 3 (JES3) control statements 


This publication is designed as a reference book, to be used while coding the statements. It 
contains some introductory material. Full explanations of the job control tasks are presented in 
a companion book, MV S/Extended Architecture JCL User's Guide, GC28-1351. 


Trademarks 


The following are trademarks of International Business Machines Corporation. 


° MVS/DFP™ 
e MVS/SP™ 
° MVS/XA™ 


Who Should Use this Publication 


This book is needed by system and application programmers who enter programs into the 
operating system. Those using this book should understand the concepts of job management 
and data management. 


Information in This Publication 


Chapter 1. Job Control Statements: This chapter introduces the job control statements. 


Chapter 2. Job Control Tasks: This chapter contains charts of job control tasks and the 
statements and parameters that can be used to perform the tasks. 


Chapter 3. Format of Job Control Statements: This chapter describes the fields in job control 
statements and how to continue fields onto following statements. 
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Chapter 4. Syntax: This chapter describes: 
e Notation used to show the syntax of job control parameters. 


e Character sets used in coding job control statements. 
e Backward references and their use. 


Chapter 5. Cataloged and In-Stream Procedures: This chapter presents the information needed 
to code and use cataloged and in-stream procedures. 


Chapter 6. Job Control Statements jon the Output Listing: This chapter shows how job control 
statements are identified on the job log output listing. 


Chapters 7 through 20: These chapters detail the coding of each JCL statement, in alphabetical 


order, and of each parameter, in alphabetical order by statement. The chapters are: 


Chapter 7. 
Chapter 8. 
Chapter 9. 


Chapter 10. 
Chapter 11. 
Chapter 12. 
Chapter 13. 
Chapter 14. 
Chapter 15. 
Chapter 16. 
Chapter 17. 
Chapter 18. 
Chapter 19. 
Chapter 20. 


Command Statement 
Comment Statement 
CNTL Statement 

DD Statement 

Special DD Statements 
Delimiter Statement 
ENDCNTL Statement 
EXEC Statement 

JOB Statement 

Null Statement 
OUTPUT JCL Statement 
PEND Statement 
PROC Statement 
XMIT JCL Statement 


For the DD, EXEC, JOB, and OUTPUT JCL statements, the chapter introduction includes 
charts summarizing all the parameters, their values, and their purposes. These charts should 
help the new JCL coder select parameters and act as a reminder for the experienced coder. 


Except for chapter 11, each of these chapters cover only one statement. In them, the 
parameters are listed alphabetically. For each statement and parameter, the following 


information is given, as needed: 

e Parameter type: positional or keyword, required or optional, and if it applies for SMS. 
e Purpose of the parameter. 

e References to related information in other IBM publications. 

e Syntax and coding rules. 

e Parameter or subparameter definitions: how to code each parameter or subparameter. 
e Defaults if you do not code a statement, parameter, or subparameter. 


e Overrides: statements that this statement overrides or is overridden by or parameters that 
this parameter overrides or is overridden by. 
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e Relationship to other parameters, including other parameters or subparameters that should 
not be coded with this one. 


e Relationship to other control statements. 

@e On EXEC statement that calls a procedure, for EXEC statement parameters. 

e Location in the JCL. 

e Other information required to code the statement or parameter. 

@e Examples. 

Chapter 21. JES2 Statements: This chapter details the coding of JES2 control statements. 


Chapter 22. JES3 Statements: ‘This chapter details the coding of JES3 control statements. 


Guide to Using this Publication 


If your system contains MVS/System Product - JES2 Version 2 (program number 5740-XC6), 
JES2 information in this manual refers to the JES2 function in the MVS/System Product 
Version 2, unless otherwise noted. 


If your system contains MVS/System Product - JES3 Version 2 (program number 5665-291), 
JES3 information in this manual refers to the JES3 function in the MVS/System Product 
Version 2, unless otherwise noted. 


Your system must contain Resource Access Control Facility (RACF) Program Product 
(program number 5740-XXH), in order for you to specify the PROTECT parameter on your 
DD statements and to use the GROUP, PASSWORD, and USER parameters on the JOB 
statement. 


JCL Statements no Longer Supported or Supported Differently: Parameters introduced in OS 
but not supported in MVS/System Product are: 


e Main storage hierarchy support and rollout/rollin. The system will check the 
HIERARCHY and ROLL parameters only for correct syntax. 


e The SEP parameter, the AFF parameter, and the UNIT=SEP subparameter on the DD 
statement. The system will check them only for correct syntax. The job will fail if they are 
coded incorrectly. 


JCL DD parameters supported differently are: 

e SPLIT and SUBALLOC. Their values are converted internally to SPACE requests. When 
the SUBALLOC keyword is coded, the DD statement for which space is allocated becomes 
a dummy DD. 

e Fora JES3 system, the UNIT parameter on a DD statement that names a cataloged data 
set cannot specify a device type that conflicts with the cataloged device type. For example, 


a 3330 and a 3375. 


Supported in MVS/System Product Version 1 but not in Version 2 are the CODE and FRID 
subparameters of the DCB parameter on the DD statement. 
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Prerequisite Publication 


Introduction to Virtual Storage in System/370, GR20-4260. 


Co-requisite Publication 


MVS/Extended Architecture JCL User’s Guide, GC28-1351. 


Publications Cited in the Text 
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Vocabulary for Data Processing, Telecommunications, and Office Systems, GC20-1699. 


Base Control Program 


MVS/Extended Architecture System Programming Library: System Modifications, 
GC28-1152. 
MVS/Extended Architecture Supervisor Services and Macro Instructions, GC28-1154. 


MVS/Extended Architecture System Programming Library: System Macros and Facilities, 


Volumes | and 2, GC28-1150 and GC28-1151. 

MVS/Extended Architecture Operations: System Commands, GC28-1206. 
MVS/Extended Architecture System Programming Library: Initialization and Tuning, 
GC28-1149. 
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MVS]/Extended Architecture Debugging Handbook, Volumes | through 6, LY28-1176 
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MVS/Extended Architecture Installation: System Generation, GC26-4148. 
MVS/Extended Architecture Injeractive Problem Control System (IPCS) User's Guide, 
GC28-1407. 


Data Facility Product - Version 2 


MVS/Extended Architecture System-Data Administration, GC26-4149. 
MVS/Extended Architecture Data Administration Guide, GC26-4140. 

MVS/Extended Architecture Integrated Catalog Administration: Access Method Services 
Reference, GC26-4135. 

MVS/Extended Architecture VSAM Catalog Administration: Access Method Services 
Reference, GC26-4136. 

MVS/Extended Architecture Checkpoint/Restart User's Guide, GC26-4139. 
MVS/Extended Architecture Data Administration: Utilities, GC26-4150. 
MVS/Extended Architecture Magnetic Tape Labels and File Structure Administration, 
GC26-4145. 

MVS/Extended Architecture VSAM Administration Guide, GC26-4151. 
MVS/Extended Architecture Interactive Storage Management Facility User’s Guide, 
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| Data Facility Product - Version 3 


| MVS/ESA System-Data Administration, SC26-4515. 

| MVS/ESA Data Administration Guide, SC26-4505. 

| MVS/ESA Storage Administration Reference, SC26-4514. 

| MVS/ESA Integrated Catalog Administration: Access Method Services Reference, 
| SC26-4500. 

| MVS/ESA VSAM Catalog Administration: Access Method Services Reference, SC26-4501. 
| MVS/ESA Checkpoint/Restart User's Guide, SC26-4503. 

| MVS/ESA Data Administration: Utilities, SC26-4516. 

| MVS/ESA Magnetic Tape Labels and File Structure Administration, SC26-4511. 

| MVS/ESA VSAM Administration Guide, SC26-4518. 

| MVS/ESA Interactive Storage Management Facility User's Guide, SC26-4508. 


JES2 


MVS/Extended Architecture System Programming Library: JES2 Initialization and Tuning, 
SC23-0065. 
MVS/Extended Architecture Operations: JES2 Commands, SC23-0064. 


JES3 


MVS/Extended Architecture System Programming Library: JES3 Initialization and Tuning, 
SC23-0059. 

MVS/Extended Architecture Operations: JES3 Commands, SC23-0063. 

MVS/Extended Architecture JES3 Diagnosis, LC28-1370. 

MVS/Extended Architecture System Programming Library: JES3 User Modifications and 
Macros, LC28-1372. 


Programs 


Advanced Communications Function for VTAM Version 2 Programming, SC27-0611. 
Advanced Communications Function for TCAM, Version 2 Installation Reference, SC30-3133. 
OS/VS Mass Storage System (MSS) Services General Information, GC35-0016. 

Resource Access Control Facility (RACF) General Information Manual, GC28-0722. 
Resource Access Control Facility (RACF) Security Administrator's Guide, SC28-1340. 
MVS/Extended Architecture System Programming Library: Service Aids, GC28-1159. 
MVS/Extended Architecture System Programming Library: System Management Facilities 
(SMF), GC28-1153. 


Hardware 


Print Management Facility User's Guide and Reference, SH35-0059. 

IBM 3800 Printing Subsystem Models 3 and 8 Programmer's Guide, SH35-0061. 

2821 Control Unit Component Description, GA24-3312. 

OS and OS/VS Programming Support for the IBM 3505 Card Reader and IBM 3525 Card 
Punch, GC21-5097. 

OS/VS2 IBM 3540 Programmer's Reference, GC24-5111. 

3800 Printing Subsystem Programmer's Guide, GC26-3846. 

Forms Design Reference Guide for the IBM 3800 Printing Subsystem, GA26-1633. 

Print Services Facility User's Programming Guide for MVS, 8544-3084. 

Print Services Facility System Programmer's Guide for MVS, SH35-0091. 
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Summary of Amendments 


Summary of Amendments 
for GC28-1352-4 
for MVS/System Product Version 2 Release 2.3 


This major revision supports MVS/System Product Version 2 Release 2.3. Changes include: 


MVS/XA support for MVS/Data Facility Product (MVS/DFP) Version 3 Release 1.0, 
which introduces the Storage Management Subsystem (SMS). SMS provides new function 
for data and storage management. 


In this book, “with SMS” indicates information that applies when SMS is installed and 
active; “without SMS” indicates SMS is not installed or is not active. 


For JCL, MVS/XA adds nine DD statement parameters for defining new data sets with 
SMS. Note that the system ignores these DD parameters when SMS is not installed or is 
not active. 


The new DD parameters are: 


— AVGREC .- average record 

— DATACLAS - data class 

— KEYOFF .- key offset 

— LIKE - like dsname 

— MGMTCLAS - management class 
— RECORG .- record organization 
— REFDD - reference ddname 

— SECMODEL .-- security model 

~— STORCLAS - storage class * 


* When a storage class is assigned to a new data set, the data set is referred to as an 
”“SMS-managed data set”. 


There are also changes to the following DD statement parameters for defining data sets 
with SMS. 


— SPACE=(recigth... - record length 
— SPACE=((,,directory)) - directory quantity only 


With SMS, do not use the JOBCAT DD statement in jobs and STEPCAT DD statements 


in steps that reference SMS-managed data sets. SMS only accesses SMS-managed data sets 
that are cataloged in a system catalog. 
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With SMS, you can define new VSAM data sets with DD statements (see the DATACLAS 
and RECORG parameters). Also, the disposition processing of VSAM data sets is changed 
(see the DISP parameter). 

e Alternate syntax for the DD LABEL and DCB parameters. 


— On the LABEL DD parameter, you can specify EXPDT and RETPD subparameters 
without the need to code LABEL=. 


— On the DCB DD parameter, you can specify all DCB keyword subparameters without 
the need to code DCB=. 


e The following subparameters of the LABEL and DCB DD parameters are now described as 
DD parameters. 


— EXPDT - expiration date (from LABEL) 

— RETPD - retention period (from LABEL) 
— KEYLEN .- key length (from DCB) 

— LRECL - logical record length (from DCB) 
— RECFM .- record format (from DCB) 


e Maintenance updates, including the following: 


— Parameter THWSSEP is added to the //*MAIN statement for JES3 support of the IBM 
3480 Automatic Cartridge Loader (from Technical Newsletter GN28-1198). 


— Parameter SUBCHARS is added to the // XMIT JCL statement (from Technical 
Newsletter GN28-1254). 


— Qn the JES3 //*MAIN statement, the mmm subparameter is added for the WARNING 
subparameter on the BYTES, CARDS, LINES, and PAGES parameters. 


— Information for RACF Release 1.6 is removed from the DD PROTECT parameter. 


— Information for previous releases of JES2 related to held data sets is removed from the 
DD SYSOUT and OUTPUT JCL CLASS parameters. 


— The reference tables in Chapter 23 are removed. 


— For mutually exclusive DD parameters, see the description of the individual 
parameters on the DD statement. 


— For direct access and track capacities, see Data Administration Guide. 


— Change to DCB BLKSIZE. If BLKSIZE is not specified, the system determines an 
optimum block size for the data. 


— Updates are made to the DD AMP parameter. 


— Other updates throughout the book. 
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Summary of Amendments 

for GC28-1352-3 

as Revised June, 1987 

This major revision supports MVS/System Product Version 2 Release 2.0. Changes include: 


e An expiration date with a four-digit year (through 2155) can be specified for a data set on 
the EXPDT subparameter of the LABEL parameter. 


@ The expiration date for a data set that is calculated with the RETPD subparameter of the 
LABEL parameter uses 366 days for leap years. 


e The maximum number of DD statements allowed per job step is increased from 1635 to 
3273. 


e Maintenance updates, including the following: 
— Information for the JES2 Greater than 99 Printer Support Enhancement, which allows 
route codes up to 9999 to be specified for remote work stations and local and remote 


terminals. 


— Information for the DATACK and PIMSG parameters on the OUTPUT JCL 
statement. 


— Other changes throughout the book. 


Summary of Amendments 
for GC28-1352-2 
as Revised July 31, 1986 


This major revision supports the JES3 SNA/NJE Enhancement by addition of the XMIT JCL 
statement. 


It also contains maintenance updates. 
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Chapter 1. Job Control Statements 


This chapter lists in Figure 1-1 all the job control statements and gives the purpose of each 
statement. Each statement is described in detail in later chapters. 


JCL Statements 


// command 


//* comment 


/| CNTL 
/| DD 


/* 


/| ENDCNTL 
/| EXEC 


/| JOB 


// 
// OUTPUT 


/| PEND 
/| PROC 


/| XMIT 


Figure 1-1 (Part 1 of 2). 


JCL command 


comment 


control 
data definition 


delimiter 


end control 


execute 


job 
null 


output JCL 


procedure end 


procedure 


transmit 


Enters an MVS system operator command through the input stream. 


The command statement is used primarily by the operator. 


Note: JES3 ignores the JCL command statement. 


Contains comments. The comment statement is used primarily to 
document a program and its resource requirements. 


Marks the beginning of one or more program control statements. 


Identifies and describes a data set. 


: Indicates the end of data placed in the input stream. 


Note: Any two characters can be designated by the user to be the 
delimiter. 


Marks the end of one or more program control statements. 

Marks the beginning of a job step; assigns a name to the step; identifies 
the program or the cataloged or in-stream procedure to be executed in 
this step. 

Marks the beginning of a job; assigns a name to the job. 


Marks the end of a job. 


Specifies the processing options that the job entry subsystem is to use for 
printing a sysout data set. 


Marks the end of an in-stream procedure. 

Marks the beginning of an in-stream procedure and may mark the 
beginning of a cataloged procedure; assigns default values to parameters 
defined in the procedure. 


Transmits input stream records from one node to another. 


Note: The XMIT JCL statement is supported only on JES3 systems. 


Job Control Statements 
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Statements 


JES2 Control Statements 


/*$command Enters JES2 operator commands through the input stream. 


/*JOBPARM Specifies certain job-related parameters at input time. 
/*MESSAGE Sends messages to the operator via the operator console. 
/*NETACCT Specifies an account number for a network job. 
/*NOTIFY Specifies the destination of notification messages. 
/*OUTPUT Specifies processing options for sysout data set(s). 
/*PRIORITY Assigns a job queue selection priority. 

/*ROUTE Specifies the output destination or the execution node for the job. 
/*SETUP Requests mounting of volumes needed for the job. 
/*SIGNOFF Ends a remote job stream processing session. 
/*SIGNON Begins a remote job stream processing session. 

/*XEQ Specifies the execution node for a job. 


/*XMIT Indicates a job or data stream to be transmitted to another JES2 node 
or eligible non-JES2 node. 


JES3 Control Statements 


//**command Enters JES3 operator commands, except *DUMP and *RETURN, through 
the input stream. 


//*DATASET Begins an input data set in the input stream. 
//*ENDDATASET Ends the input data set that began with a //*DATASET statement. 
//*ENDPROCESS Ends a series of //*“PROCESS statements. 


//*FORMAT Specifies the processing options for a sysout or JES3-managed print or 
punch data set. 


//*MAIN Defines selected processing parameters for a job. 


//*NET Identifies relationships between predecessor and successor jobs in a 
dependent job contro! net. 


//*NETACCT Specifies an account number for a network job. 


//*OPERATOR Sends messages to the operator. 


//**PAUSE Halts the input reader. 

//*PROCESS Identifies a nonstandard job. 

//*ROUTE Specifies the execution node for the job. 
/*SIGNOFF Ends a remote job stream processing session. 


/*SIGNON Begins a remote job stream processing session. 


Figure 1-1 (Part 2 of 2). Job Control Statements 


1-2 MVS/XA JCL Reference 


Tasks 


Chapter 2. Job Control Tasks 


For your program to execute on the computer and perform the work you designed it to do, 
your program must be processed by your operating system. Your operating system consists of 
an MVS/SP base control program (BCP) with a job entry subsystem (JES2 or JES3) and the 
Data Facility Product (DFP) installed with it. 


For the operating system to process a program, programmers must perform certain job control 
tasks. These tasks are performed through the job control statements, which consist of: 


JCL statements 
JES2 control statements 
JES3 control statements 


Entering Jobs 


Job Steps: You enter a program into the operating system as a job step. A job step consists of 
the job control statements that request and control execution of a program and request the 
resources needed to run the program. A job step is identified by an EXEC statement. The job 
step can also contain data needed by the program. The operating system distinguishes job 
control statements from data by the contents of the records. 


Jobs: A jobis a collection of related job steps. A job is identified by a JOB statement. 


Input Streams: Jobs placed in a series and entered through one input device form an input 
stream. The operating system reads an input stream into the computer from an input/output 
(I/O) device or an internal reader. The input device can be a card reader, a magnetic tape 
device, a terminal, or a direct access device. An internal reader is a buffer that is read from a 
program into the system as though it were an input stream. 


Cataloged and In-Stream Procedures: You often use the same set of job control statements 
repeatedly with little or no change, for example, to compile, assemble, link-edit, and execute a 
program. To save time and prevent errors, you can prepare sets of job control statements and 
place, or catalog, them in a partitioned data set known as a procedure library. Such a set of 
job control statements in the system procedure library, SYS1.PROCLIB (or an 
installation-defined procedure library), is called a cataloged procedure. 


To test a procedure before placing it in the catalog, place it in an input stream and execute it; 
a procedure in an input stream is called an in-stream procedure. The maximum number of 
in-stream procedures you can code in any job is 15. 


Steps in a Job: A job can be simple or complex; it can consist of one step or of many steps 

that call many in-stream and cataloged procedures. A job can consist of up to 255 job steps, 
including all steps in any procedures that the job calls. Specification of a greater number of 

steps produces a JCL error. 
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Processing Jobs 


The operating system performs many job control tasks automatically. You can influence the 
way your job is processed by the JCL and JES2 or JES3 parameters you code. For example, 
the job entry subsystem selects jobs for execution, but you can speed up or delay selection of 
your job by the parameters you code. 


Requesting Resources 


Data Set Resources: To execute a program, you must request the data sets needed to supply 
data to the program and to receive output records from the program. 


Sysout Data Set Resources: A sysout data set is a system-handled output data set. This data 
set is placed temporarily on direct access storage. Later, at the convenience of the system, the 
system prints it, punches it, or sends it to a specified location. Because sysout data sets are 
processed by the system, the programmer can specify many parameters to control that 
processing. 


Task Charts 


The following charts list the job control tasks, which are described in the JCL User's Guide, in 
four groups: 


Entering jobs in Figure 2-1 on page 2-3 

Processing jobs in Figure 2-2 on page 2-6 

Requesting data set resources in Figure 2-3 on page 2-7 
Requesting sysout data set resources in Figure 2-4 on page 2-10 


For each task, the charts list the parameters and statements that can be used to perform it. In 
many cases, the same task can be performed using different parameters on different statements. 
Where a parameter can appear on both a JOB and EXEC statement, it applies to the entire job 
when coded on the JOB statement but only to a step when coded on an EXEC statement. 


The system is designed to enable users to perform many types of job control in many ways. To 
allow this flexibility, only two job entry tasks are required: ) 


e Identification: The job must be identified in the jobname field of a JOB statement. 


e Execution: The program or procedure to be executed must be named in a PGM or PROC 
parameter on an EXEC statement. 


Therefore, the following statements are the minimum needed to perform a job control task: 


//jobname JOB 
// EXEC |PGM=program-name 
PROC=procedure-name 
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STATEMENTS AND PARAMETERS FOR TASK 


JCL Statements JES2 Statements JES3 Statements 
JOB —_—_—_—{ EXEC Other JCL 


JOB 
jobname field null statement 
(JES3 only) 
PROC 
PEND 


ACCT /*NETACCT //*NETACCT 


ROOM PNAME, BLDG, 
on /*JOBPARM DEPT, ROOM, 

and USERID 

on //*NETACCT 


Identification 


of procedure 


accounting 
information or 

pano in JOB JES2 
accounting 
information 


of account 


of programmer programmer’s- 
name and 

room in JOB 
JES2 accounting 
information 


USER 


of program 


of procedure 


RESTART 
on /*JOBPARM 


FAILURE and 
JOURNAL 
on //*MAIN 


when restarting and 
with checkpointing 


DEADLINE 
on //*MAIN 


deadline or periodic 


when dependent on 
other jobs 


at remote node 


/*ROUTE XEQ 
/*XEQ 
/*XMIT 


Figure 2-1 (Part 1 of 3). Tasks for Entering Jobs 
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STATEMENTS AND PARAMETERS FOR TASK 


CL Statements JES2 Statements JES3 Statements 
JOB Other JCL 
by holding job en- TYPRUN HOLD, UPDATE, or 
trance CLASS CLASS on //*MAIN 
//*NET 


by holding local //*PAUSE 
input reader 
by copying input TYPRUN 
stream (JES2 only) }CLASS 
/*SIGNON /*SIGNON 
/*SIGNOFF /*SIGNOFF 


ae /*MESSAGE //*OPERATOR 


//*comment, Comment field on 
also comment //*ENDPROCESS 
field on all state- and //*PAUSE 
ments but null 
FETCH on //*MAIN 
WARNING on 
BYTES, CARDS, 
LINES, and PAGES 
on //*MAIN 


from remote work 
station 


from JCL to system 


from JCL to operator 


from JCL to pro- Comment field Comment field 


grammer unless no 


parameter field 


from JCL to program 


from system to oper- 
ator 


from system to TSO |NOTIFY /*NOTIFY ACMAIN 
userid on //*MAIN with 
JOB NOTIFY 


from TSO userid to USER on //*MAIN 
system 

from functional sub- PIMSG on 
system to pro- OUTPUT JCL 
grammer 

through job log MSGCLASS JESDS on NOLOG 


MSGLEVEL 
log in JOB 


OUTPUT JCL on /*JOBPARM 


JES2 accounting 
information 


a") gp 
: : 
Kd Q 


Figure 2-1 (Part 2 of 3). Tasks for Entering Jobs 


2-4 MVS/XA JCL Reference 


Tasks 


TASKS FOR STATEMENTS AND PARAMETERS FOR TASK 


JCL Statements JES2 Statements JES3 Statements 
JOB _[ EXEC Other ICL 


through RACF 


Resource control 


of program library JOBLIB DD 
STEPLIB DD 
DD defining 
PDS member 


of procedure library PROC and UPDATE 
on /*JOBPARM on //*MAIN 


of address space 
on //*MAIN 


of processor SYSAFF SYSTEM 
on /*JOBPARM on //*MAIN 


of spool partition SPART and 
TRKGRPS 
on //*MAIN 


Figure 2-1 (Part 3 of 3). Tasks for Entering Jobs 
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TASKS FOR 
PROCESSING 
JOBS 


Processing control 
by terminating exe- 


cution 


by timing execution 


for testing: 
(1) by altering 
usual processing 


(2) by dumping 
after error 


STATEMENTS AND PARAMETERS FOR TASK 


JCL Statements 
JOB __ [EXEC Other JCL 


TIME 

or time in JOB 
JES2 accounting 
information 


PGM = IEFBR14 


PGM = JCLTEST 
PGM = JSTTEST 
(JES3 only) 


SYSABEND DD 
SYSMDUMP DD 
SYSUDUMP DD 


JES2 Statements 


on /*JOBPARM 


JES3 Statements 


CANCEL in BYTES, 
CARDS, LINES, 
and PAGES 

on //*MAIN 


//*PROCESS 
|/*ENDPROCESS 


DUMP in BYTES, 
CARDS, LINES, 
and PAGES 


on //*MAIN 
To format dump 
on 3800 Print- 
ing Subsystem, 
FCB=STD3 and 
CHARS = DUMP 
on dump DD 


Performance control 


by job class assign- 
ment 


/*PRIORITY 


by selection priority 


by dispatching prior- 
ity 


by performance 
group assignment 


by I/O-to-processing 


ratio on //*MAIN 


Figure 2-2. Tasks for Processing Jobs 
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TASKS FOR 


STATEMENTS AND PARAMETERS FOR TASK 


REQUESTING DATA | JCL Statements JES2 Statements JES3 Statements 
SET RESOURCES UTPUT JCL Other JCL 


Identification 


UPDATE 
on //*MAIN 


of data set 


of in-stream data set //*DATASET 


//*ENDDATASET 


of data set on 3540 


Diskette Input/Out- 
put Unit 
through catalog JOBCAT DD 
STEPCAT DD 
through label label-type 


on LABEL 


by location on tape [data-set- 
sequence-number 


on LABEL 


as TCAM message 
data set 


from or to terminal 


of status 


of data attributes 


- by modeling 


of migration and MGMTCLAS 
backup 


Figure 2-3 (Part 1 of 3). Tasks for Requesting Data Set Resources 
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REQUESTING DATA 
SET RESOURCES 


through RACF 


for ISO/ANSI/FIPS 
Version 3 tapes 


by passwords 


of access to BSAM 
and BDAM data 
sets 


Allocation 


of device 


of tape or direct 
access volume 


of direct access space 


DATACLAS 


of virtual I/O 


DSNAME = tem- 
porary data set 


with deferred vol- 
ume mounting 


with volume pre- 
mounting 


dynamic 


Figure 2-3 (Part 2 of 3). 


SECMODEL 


ACCODE 


PASSWORD and 
NOPWREAD 
on LABEL 


IN and OUT 
on LABEL 


DEFER 
on UNIT 


STATEMENTS AND PARAMETERS FOR TASK 


ICL Statements SSSSSCS~*~SS Statement 


JES3 Statements 


Other JCL 


CLASS 
on JOB 
(JES3 only) 


SETUP, MSS, 
and CLASS 
on //*MAIN 


EXPDTCHK 
and RINGCHK 
on //*MAIN 


/*SETUP 


DYNAMNBR 


on EXEC 


Tasks for Requesting Data Set Resources 
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TASKS FOR STATEMENTS AND PARAMETERS FOR TASK 


REQUESTING DATA 
SET RESOURCES 


Processing control 


by suppressing pro- 
cessing 


by postponing speci- 
fication 


with checkpointing |CHKPT 
SYSCKEOV DD 


by subsystem SUBSYS 
CNTL 


by TCAM job or task} QNAME 


End processing 
deallocation 


disposition of 
data set 


release of unused 
direct access space 


disposition of RETAIN and 
volume PRIVATE 
on VOLUME 


JES2 Statements 
Other JCL 
CNTL 


ENDCNTL 


Figure 2-3 (Part 3 of 3). Tasks for Requesting Data Set Resources 
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TASKS FOR STATEMENTS AND PARAMETERS FOR TASK 


REQUESTING JCL Statements JES2 Statements JES3 Statements 
SYSOUT RESOURCES [DD == =~—S || OUTPUT JCL__| Other JCL 


Identification 


as a sysout data set 


of output class MSGCLASS 
on JOB with 
SYSOUT=* or 
CLASS = * and 
SYSOUT =(,) 


of data set on 3540 
Diskette Input/Out- 
put Unit 


Description 


of data attributes 


Performance control 


by queue selection 


Figure 2-4 (Part 1 of 4). Tasks for Requesting Sysout Data Set Resources 
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TASKS FOR 


REQUESTING 


SYSOUT RESOURCES 


Processing control 
with additional 


parameters 


with other data sets 


by external writer 


by mode 


by holding 


by suppressing out- 
put 


with checkpointing 


by Print Services 
Facility (PSF) 


Figure 2-4 (Part 2 of 4). 


STATEMENTS AND PARAMETERS FOR TASK 


code-name 
on SYSOUT 


class THRESHLD 

on SYSOUT (JES3 only) 
GROUPID 

(JES2 only) 


writer-name 
on SYSOUT 


HOLD 
class 
on SYSOUT 


DUMMY 
class 
on SYSOUT 


Tasks for Requesting Sysout Data Set Resources 
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Tasks 


TASKS FOR STATEMENTS AND PARAMETERS FOR TASK 


REQUESTING JCL Statements JES2 Statements JES3 Statements 
SYSOUT RESOURCES [DD  —=—S*Y|{ OUTPUT JCL__| Other JCL 
deallocation FREE } 


Destination control 
to local or remote DEST DEST /*ROUTE PRINT 
device or to class COMPACT /* ROUTE PUNCH 
another node on SYSOUT 


to another processor ACMAIN 
on //*MAIN 


to internal reader 
as writer-name 
on SYSOUT 


to terminal 


Figure 2-4 (Part 3 of 4). Tasks for Requesting Sysout Data Set Resources 
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TASKS FOR STATEMENTS AND PARAMETERS FOR TASK 


REQUESTING JCL Statements JES2 Statements JES3 Statements 
SYSOUT RESOURCES |DD = =——s JOUTPUT JCL__‘[ Other JCL 


Output formatting 


to any printer forms, copies, COPIES, FORMS, 
and linect on JOB |and LINECT 
JES2 accounting on /*JOBPARM 
on SYSOUT information 


(JES2 only) 
UCS 
CONTROL 


UCS 


to 3800 Printing Sub- BURST 
system, in addition on /*JOBPARM 
to most of printer 
parameters 


to 3211 Printer with INDEX (JES2 
indexing feature LINDEX only) 
— 


to punch 


on SYSOUT 
DCB=FUNC =I 


of dumps on 3800 CHARS=DUMP |CHARS=DUMP 
Printing Subsys- FCB=STD3 
tem 


OUTLIM lines and cards BYTES, CARDS, BYTES, CARDS, 
on JOB LINES, and PAGES _| LINES, and PAGES 
JES2 accounting on /*JOBPARM on //*MAIN 
information 


Figure 2-4 (Part 4 of 4). Tasks for Requesting Sysout Data Set Resources 
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Chapter 3. Format of Statements 


This chapter describes the fields in JCL, JES2 and JES3 statements. It ends with the 
conventions for continuing statements. 


JCL Statement Fields 


A JCL statement consists of one or more 80-byte records. Each record is in the form of an 
80-column punched-card image. Each JCL statement is logically divided into the following five 
fields. All five fields do not appear on every statement; see Figure 3-1 on page 3-2 for the 
fields that can appear on each statement. 


Identifier field 
The identifier field indicates to the system that a statement is a JCL statement rather than 
data. The identifier field consists of the following: 


e Columns 1 and 2 of all JCL statements, except the delimiter statement, contain // 


@ Columns 1 and 2 of the delimiter statement contain either /* or two other characters 
designated in a DLM parameter to be the delimiter 


e Columns 1, 2, and 3 of a JCL comment statement contain //* 

Name field 
The name field identifies a particular statement so that other statements and the system 
can refer to it. For JCL statements, code the name as follows: 


e The name must begin in column 3. 


e The name is | through 8 alphanumeric or national ($, #, @) characters. See 
Figure 4-2 on page 4-4 for the character sets. 


e The first character must be an alphabetic or national ($, #, @). 
e The name must be followed by at least one blank. 
Operation field 
The operation field specifies the type of statement, or, for the command statement, the 
command. Code the operation field as follows: 
e The operation field consists of the characters in the syntax box for the statement. 


e The operation follows the name field. 
e The operation must be preceded and followed by at least one blank. 
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Parameter field 
The parameter field contains parameters separated by commas. Code the parameter field 
as follows: 


e@ The parameter field follows the operation field. 
@ The parameter field must be preceded and followed by at least one blank. 


See “Parameter Field” on page 3-3 for details on coding the parameter field. 


Comments field 
The comments field contains any information you deem helpful when you code the 
control statement. Code the comments field as follows: 


e The comments field follows the parameter field. 
e The comments field must be preceded by at least one blank. 


You can code comments after the parameter field even though you continue the 
parameter field on a subsequent statement; see “Continuing JCL Statements” on 
page 3-5. 


For most statements, if you do not code any parameters, do not code any comments. 


Statement Fields 


JCL Command // command [parameter] [comments] 
Comment //* comments 
CNTL /label CNTL [* comments] 


DD //[ddname] DD [parameter [comments]] 
//[ddname] DD 


Delimiter /* [comments] 
xx [comments] 


ENDCNTL //(label] ENDCNTL [comments] 
EXEC //[stepname] EXEC parameter [comments] 


JOB //jjobname JOB [parameter [comments]] 
//jjobname JOB 


Null // 
OUTPUT JCL //(name OUTPUT parameter [comments] 
PEND //[name] PEND [comments] 


PROC (cataloged) //Mame] PROC [parameter [comments]] 
//Mame] PROC 


PROC (in-stream) //name PROC [parameter [comments]] 
/mame PROC 


Figure 3-1. JCL Statement Fields 


Location of Fields on Statements: Code the identifier field beginning in column 1 and the name 
field immediately after the identifier, with no intervening blanks. Code the operation, 
parameter, and comments fields in free form. Free form means that the fields need not begin in 
a particular column. Between fields leave at least one blank; the blank serves as the delimiter 
between fields. 
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Do not code fields, except on the comment statement, past column 71. If the total length of the 
fields would exceed 71 columns, continue the fields onto one or more following statements. 
Continuing fields is described under “Continuing JCL Statements” on page 3-5. The comment 
statement can be coded through column 80. 


Use Keywords Only for Parameters or Subparameters: Do not use parameter or subparameter 
keywords from any JCL, JES2, or JES3 statements as symbolic parameters, names, or labels. 


Parameter Field 


The parameter field consists of two types of parameters: positional parameters and keyword 
parameters. All positional parameters must precede all keyword parameters. Keyword 
parameters follow the positional parameters. 


Commas: Use commas to separate positional parameters, keyword parameters, and 
subparameters in the parameter field. 


Positional Parameters: A positional parameter consists of (1) characters that appear in 
uppercase in the syntax and must be coded as shown, (2) variable information, or (3) a 
combination. For example, DATA on a DD statement, programmer’s-name on a JOB 
statement, and PGM = program-name on an EXEC statement. 


Code positional parameters first in the parameter field in the order shown in the syntax. If you 
omit a positional parameter and code a following positional parameter, code a comma to 
indicate the omitted parameter. Do not code the replacing comma if: 


The omitted positional parameter is the last positional parameter. 
All following positional parameters are also omitted. 

Only keyword parameters follow. 

All positional parameters are omitted. 


Keyword Parameters: A keyword consists of characters that appear in uppercase in the syntax 
and must be coded as shown followed by an equals sign followed by either characters that must 
be coded as shown or variable information. For example, RD=R and 

MSGCLASS =class-name on the JOB statement. 


Code any of the keyword parameters for a statement in any order in the parameter field after 
the positional parameters. Because of this positional independence, never code a comma to 
indicate the absence of a keyword parameter. 


Multiple Subparameters: A positional parameter or the variable information in a keyword 
parameter sometimes consists of more than one item, called a subparameter list. A 
subparameter list can consist of both positional and keyword subparameters. These 
subparameters follow the same rules as positional and keyword parameters. 


When a parameter contains more than one subparameter, separate the subparameters by 
commas and enclose the subparameter list in parentheses or, if indicated in the syntax, by 
apostrophes. If the list is a single keyword subparameter or a single positional subparameter 
with no omitted preceding subparameters, omit the parentheses or apostrophes. 
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JES2 Control Statement Fields 


The rules for coding JES2 control statements are the same as the rules for JCL statements, with 
the following additions: 


@ Columns | and 2 always contain the characters /* 


e Do not code comments on any JES2 statements. Where comments are needed, code a JCL 
comment statement. 


e@ If you code the same parameter on the same statement more than once, JES2 uses the value 
in the last parameter. 


When coding a JES2 control statement more than once, be aware of the following JES2 actions: 


e Ifthe same parameter appears on more than one statement, JES2 uses the value coded on 


the last statement. ) 


e Ifthe statements contain different parameters, JES2 uses all parameters combined. 


JES3 Control Statement Fields 


The rules for coding JES3 control statements are the same as the rules for JCL statements, with 
the following additions: 


e Columns 1, 2, and 3 contain the characters //* except for two JES3 control statements that 
contain /* in columns 1 and 2. 


e Columns 3 and 4 must not be blank. 
@ Do not code comments on JES3 control statements, except //*ENDPROCESS and 


//*PAUSE statements. Where additional comments are needed, code a JCL comment 
statement. 
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Continuing Statements 


Continuing JCL Statements 


When the total length of the fields on a control statement exceeds 71 columns, continue the 
fields onto one or more following statements. 


JCL statements that you cannot continue follow. While you cannot continue these statements, 
you can code as many separate statements as you need. 


Command statement 
Comment statement 
Delimiter statement 
Null statement 
For all other JCL statements, you can continue the parameter field or the comments field. 


Continuing the Parameter Field: 


1. Interrupt the field after a complete parameter or subparameter, including the comma that 
follows it, at or before column 71. 


2. Include comments by following the interrupted parameter field with at least one blank. 


3. Code a nonblank character in column 72 when you are continuing a comments field and, 
optionally, when you are continuing the parameter field. 


Note: The system treats a following statement as a continuation, even when column 72 is 
blank, when conventions 4, 5, and 6 are followed. 


4. Code // in columns 1 and 2 of the following statement. 


5. Continue the interrupted parameter or field beginning in any column from 4 through 16. If 
you begin coding after column 16, the system treats this statement as a comment field. 


6. Column 3 of the following statement can contain only a blank or an asterisk. If column 3 
contains anything else, the system assumes the following statement is a new statement. The 
system issues an error message indicating that no continuation is found and fails the job. 

Continuing the Comments Field: 

1. Interrupt the comment at a convenient place before column 72. 

2. Code a nonblank character in column 72. 

3. Code // in columns 1 and 2 of the following statement. 

4 


Continue the comments field beginning in any column after column 3. 


You can also use a comments statement to include continued comments. 
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Examples of Continued Statements: 


//DS1 DD DSNAME=INDS,DISP=OLD,CHKPT=EOV, MY INPUT DATA SET 
// UNIT=SYSSQ , VOLUME=SER=(TAPEO1,TAPEO2, TAPEO3) 


//DD1 DD DSNAME=SWITCH.LEVEL18.GROUP12,UNIT=3350, 
J / VOLUME=335023,SPACE=(TRK, (80,15) ) ,DISP=(,PASS) 


//STP4 EXEC PROC=BILLING,COND.PAID=((20,LT) ,EVEN), 


Ve COND.LATE=(60,GT,FIND), 

Ve. COND.BILL=((20,GE),(30,LT,CHGE)) THIS STATEMENT CALLS X 
Ti THE BILLING PROCEDURE AND SPECIFIES RETURN CODE TESTS 

//* FOR THREE PROCEDURE STEPS. 


This example shows continuation of comments, first, according to the four rules above and, 
then, onto a comments statement. } 


Continuing JES2 Control Statements 


The only JES2 control statement that you can continue is the /*OUTPUT statement. For all 
other JES2 control statements, code the statement as many times as needed. 


Continuing JES3 Control Statements 


Continue JES3 statements, except the command statement or //*NETACCT statement, by: 


1. Coding a comma as the last character of the first statement. 
2. Coding //* in columns | through 3 of the continuation statement. 
3. Resuming the code in column 4 of the continuation statement. 


On the JES3 //*NET statement, each parameter must appear entirely on one statement; a 

subparameter cannot be continued after a comma, except for the RELEASE parameter. To 

continue the RELEASE parameter, end the statement with the comma following a jobname and 

continue the next statement with the next jobname. The left parenthesis appears at the Zo 
beginning of the jobname list and the right parenthesis appears at the end of the list. For 

example: 


//*NET NETID=EXP1,RELEASE=(JOB35 ,JOB27Z,MYJOB, 
/ /*WRITIB , JOBABC) 


If the parameters on a //*NETACCT statement cannot fit on one statement, code more than 
one //*NETACCT statement. 
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Chapter 4. Syntax of Parameters 


Syntax rules define how to code the fields and parameters on job control statements. The 
syntax indicates: 


@ What the system requires. 
@ What is optional for the specific purpose or process you are requesting. 
( @ How the parameters are to appear. 


The syntax rules apply to all job control statements: JCL statements, JES2 control statements, 
and JES3 control statements. 


You must follow the syntax rules in coding job control statements to achieve specific results. If 
you do not follow the rules, you may get error messages or unpredictable results. IBM does not 
support the use of statements or parameters to achieve results other than those stated in this 
publication. 


C Notation Used to Show Syntax 


The syntax of the job control statements and of their parameters appear in the chapters that 
describe the statements. The notation used in this publication for the syntax is shown in 
Figure 4-1 on page 4-2. 
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Syntax: Notation 


Uppercase letters, words, 
and characters 


Code uppercase letters, words, and the following 
characters exactly as they appear in the syntax. 


&  ampersand 

* asterisk 

; comma 

= equal sign 

() parentheses 
period 

slash 


Syntax: on JOB statement 
CLASS = jobname 


Lowercase letters, words, and symbols in the syntax 
represent variables. Substitute specific information 
for them. 


Lowercase letters, words, 
and symbols 


Coded: 
CLASS=A 


Syntax: on DD DCB parameter 
BFALN = {F|D} 


A vertical bar indicates an exclusive OR. Never code 
| on a control statement. It is used between choices 
within braces or brackets; it indicates that you code 
only one of the items within the braces or brackets. 


| (vertical bar) 


Coded: 
BFALN =F 


or 
BFALN=D 


Syntax: on DD SPACE parameter 


Braces surround required, related items and indicate 


that you must code one of the enclosed items. TRK 
Never code { or } on a control statement. CYL 
blklgth 


Coded: 
TRK 
CYL 

960 


[] (brackets) Syntax: on DD UNIT parameter 


[,DEFER] 


Brackets surround an optional item or items and 
indicate that you can code one or none of the 
enclosed items. Never code [ or ] on a control 
statement. 


omitted 


Syntax: on DD LABEL parameter 


»,RETPD = nnon 
,EXPDT =( yyddd 
yyyy/ddd 


Coded: 
,RETPD = noon 


or 
,EXPDT = yyddd 
or 
,EXPDT = yyyy/ddd 
or 


omitted 


Figure 4-1 (Part 1 of 2). Notation Used to Show Syntax 
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__ (underline) 


.. (ellipsis) 


.. (two consecutive 
periods) 


One of the items in braces or brackets can be a 
comma. Code the comma when you do not code 
any of the other items in the braces or brackets but 
you are coding a following part of the parameter. 


An underline indicates the default that the system 
uses when you do not code a subparameter. 


An ellipsis follows an item that you can code more 
than once. Never code ... on a control statement. 


Two consecutive periods indicate that a parameter 
consists of a symbolic parameter followed by a 
period and then by other code, so that only part of 
the parameter is variable. 


Figure 4-1 (Part 2 of 2). Notation Used to Show Syntax 


Syntax: on DD UCS parameter 
UCS = (character-set-code[, FOLD], ] 
[, VERIFY]) 


Coded: 
UCS = (character-set-code) 
UCS = (character-set-code, FOLD) 


UCS = (character-set-code, FOLD, VERIFY) 


UCS = (character-set-code,, VERIFY) 


Note that the comma is not coded if both 


FOLD and VERIFY are omitted, but must 


appear if FOLD is omitted and VERIFY 
follows. 


Syntax: on JOB or EXEC statement 
ADDRSPC = {VIRT|REAL} 


Coded: 


ADDRSPC omitted means 
ADDRSPC = VIRT 


Syntax: on DD statement 


COND = ((code,operator)[,(code,operator)]....) 


Coded: 
Can repeat ,(code,operator) 


Ss: 
COND = ((12,GE),(8,EQ),(4,EQ)) 


Coded: 
&DEPT..NYC 


Meaning: 
If &DEPT is D27: 
D27.NYC is the value 
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Character Sets 


To code job control statements, use characters from the three character sets in Figure 4-2. 
Figure 4-3 lists the special characters that have syntactical functions in job control statements. 


Alphanumeric Alphabetic Capital A through Z 
Numeric 0 through 9 
@ 
National $ 
# 


“At” sign 
Dollar sign 
Pound sign 


(See note) 


Comma 
Period 
Slash 
Apostrophe 

Left parenthesis 
Right parenthesis 
Asterisk 
Ampersand 

Plus sign 
Hyphen 

Equal sign 

Blank 


Note: The system recognizes the following hexadecimal representations of the U.S. National 
characters; @ as X’7C’; $ as X’5B’; and # as X’7B’. In countries other than the U.S., the 
U.S. National characters represented on terminal keyboards might generate a different 
hexadecimal representation and cause an error. For example, in some countries the $ 
character may generate a X’4A’. 


Figure 4-2. Character Sets 


Syntactical Function 


To separate parameters and subparameters 

To separate a keyword from its value, for example, BURST = YES 
To enclose a parameter or subparameter list 

To identify a symbolic parameter, for example, &LIB 

To identify a temporary data set name, for example, &&TEMPDS 
To separate parts of a qualified data set name, for example, 


A.B.C., or parts of certain parameters or subparameters, for 
example, nodename.userid 


To refer to an earlier statement, for example, OUTPUT = *.name, 
or, in certain statements, to indicate special functions: 

/flabel CNTL * 

//ddname DD * 

RESTART = * on the JOB statement 


To delimit fields 


Figure 4-3. Special Characters Used in Syntax 
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Special Characters in Parameters: The syntax or parameter description indicates if the variable 
that you code can contain special characters or not. Parameters and subparameters that can 
contain special characters not used for syntactical functions usually must be enclosed in 
apostrophes, for example, ACCT ='123 + 456’. Code each apostrophe that is part of the 
parameter or subparameter as two consecutive apostrophes, for example, code O’Neil as 
‘O'NEILL’. 


Warning: A blank can be coded only in the following: 


Accounting information on the JOB statement 
Programmer’s name on the JOB statement 
PARM parameter on the EXEC statement 
DSNAME parameter on the DD statement 


When so used, the parameter or subparameter must be enclosed in apostrophes. In any other 
parameter, even though enclosed in apostrophes, a blank is interpreted as the end of the parameter 
field; the system regards anything that follows as comments. 


Figure 4-4 lists the parameters that can contain certain special characters without requiring 
enclosing apostrophes. 


Statement and Param- | Special Characters Not Needing 
eter or Subparameter Enclosing Apostrophes Examples 


JOB accounting Hyphens (-) //JOBA JOB D58-D04 
information 


JOB programmer’s-name Hyphens (-), leading periods, or //JOBB JOB ,S-M-TU 
embedded periods. Note that //JOBC JOB ,.ABC 
a trailing period requires //JOBD JOB ,P.F.M 
enclosing apostrophes. //JOBE JOB ,’A.B.C.’ 


EXEC ACCT Hyphens (-) or plus zero (+0, an //S1 EXEC PGM=A,ACCT = D58-LOC 
overpunch) //S2 EXEC PGM = B,ACCT=D04 +0 


DD DSNAME Hyphens (-) DSNAME=A-B-C 


Periods to indicate a qualified data set} DSNAME=A.B.C 
name 


Double ampersands to identify a DSNAME= &&TEMPDS 
temporary data set name 


Parentheses to enclose the member DSNAME= PDS1(MEMA) 
name of a partitioned data set, the DSNAME = ISDS(PRIME) 
area name of an indexed sequential DSNAME=GD\S( + 1) 
data set, or the generation number 

of a generation data set 


Plus (+) or minus (-) sign to identify | DSNAME=GDS(-2) 
a generation of a generation data 
group 


DD VOLUME=SER Hyphens (-) VOLUME=SER=PUB-RD 


DD UNIT device-type Hyphens (-) UNIT = 3330-1 


Figure 4-4. Special Characters that Do Not Require Enclosing Apostrophes 
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Backward References 


Many parameters in job control statements can use a backward reference to fill in information. 
A backward reference is a reference to an earlier statement in the job or in a cataloged or 
in-stream procedure called by a job step. A backward reference is in the form: 


* name or *.ddname where name or ddname is the name field of the referenced statement. 


* stepname.name or *.stepname.ddname where the referenced statement, name or ddname, is 
in an earlier step, stepname, in the same job. 


* stepname.procstepname.name or *.stepname.procstepname.ddname where this job step or an 
earlier job step, stepname, calls a procedure; the procedure contains procedure step, 
procstepname, which contains the referenced statement, name or ddname. 


The backward reference lets you copy previously coded information or refer to an earlier 
statement. The following parameters can make backward references: 


DD CNTL refers to earlier CNTL statement 

DD DCB refers to earlier DD statement to copy its DCB parameter 

DD DSNAME refers to earlier DD statement to copy its DSNAME parameter, whether or 
not the data set is a partitioned data set, and whether or not the data set is a temporary 
data set 

DD OUTPUT refers to earlier OUTPUT JCL statement 


DD REFDD refers to earlier DD statement to copy its data set attributes 


DD VOLUME= REF refers to earlier DD statement to use the same volume(s). The 
LABEL label type subparameter is also copied from the referenced DD statement. 


EXEC PGM refers to an earlier DD statement that defines the program to be executed as a 
member of a partitioned data set 


The following statements cannot be referenced: 


DD * statement in DCB, DSNAME, or VOLUME parameter 
DD DATA statement in DCB, DSNAME, or VOLUME parameter 


DD DUMMY statement in VOLUME or UNIT parameter. The referring DD statement 
acquires a dummy status. 


DD DYNAM statement 
DD statement containing FREE=CLOSE in VOLUME or UNIT parameters 


Sysout DD statement 
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Examples of Backward References: 


//JOB1 JOB 

//STEPA EXEC ... 

//DD1 DD DSNAME=REPORT 
//DD4 DD DSNAME=* .DD1 


The referring and referenced DD statements are in the same step. 


/ /JOB2 JOB 
//STEP1 EXEC ... 
//DDA DD DSNAME=D58.POK.PUBSO1 


//STEP2 EXEC 
//DDB DD DSNAME=* .STEP1.DDA 


The referring and referenced DD statements are in different steps in the same job. 


Cataloged procedure PROC! contains: 


//PS1 EXEC 


//PSTEP1 EXEC 


//DS1 DD DSNAME=DATA1 
//PSTEP2 EXEC ... 
//DS2 DD DSNAME=DATA2 


The job contains: 


//JOB5 JOB... 
//CALLER EXEC PROC=PROC1 


//REF1 DD DSNAME=* . CALLER. PSTEP2 .DS2 
/ /NEXT EXEC ... 
/ /REF2 DD DSNAME=* .CALLER.PSTEP1.DS1 


DD statement REF1 in the calling step refers to DD statement DS2 in procedure step PSTEP2. 
DD statement REF2 in a step after the calling step refers to DD statement DS1 in procedure 
step PSTEP1. Note that the entire procedure is processed when the calling EXEC statement is 
processed; therefore, all DD statements in the procedure are earlier than all DD statements in 
the calling step. 
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Procedures 


Chapter 5. Cataloged and In-Stream Procedures 


For jobs that you run frequently or types of jobs that use the same job control, prepare sets of 
job control statements, called procedures. Place a procedure in an input stream, where it is 
called an in-stream procedure, and execute it to test it. Then place, or catalog, it in the system 
procedure library, SYS1.PROCLIB (or an installation-defined procedure library), where it 1s 
called a cataloged procedure. 


Procedure Statements: A cataloged procedure consists of EXEC, DD, OUTPUT JCL, CNTL, 
ENDCNTL, and JCL comment statements and, optionally, may begin with a PROC statement. 
An in-stream procedure consists of the same statements and must begin with a PROC statement 
and end with a PEND statement. 


The maximum number of in-stream procedures you can code in any job is 15. Each of these 15 
procedures can be called more than once. 


Note: Do not place any other JCL statements or any JES2 or JES3 control statements in a 
procedure. Do not place an in-stream data set, which begins with DD * or DD DATA, ina 
procedure. 


Using a Procedure: To execute a procedure, call it on an EXEC statement in an in-stream job. 
On the EXEC statement, specify the name of the procedure in a PROC parameter. The step 
uses the JCL statements in the procedure as if the JCL statements appeared in the input stream 
immediately following the EXEC statement. If necessary, you can modify the procedure for the 
current execution of the job step. 


If the called procedure is an in-stream procedure, place the procedure before the EXEC 
statement that calls it. 


If the called procedure is cataloged, the system retrieves it from SYS1.PROCLIB (or an 
installation-defined procedure library) unless one of the following is specified: 


e Ina JES2 system, a PROCLIB parameter on a JES2 /*JOBPARM statement. 
e Ina JES3 system, a library name in a PROC parameter on a JES3 //*MAIN statement. 


Testing a Procedure: Before putting a procedure into the procedure library, you should test it. 
For testing, place a PROC statement before the procedure and a PEND statement after it and 
place it in an input stream. For the test, call this procedure with an EXEC statement that 
appears later in the same job. After testing the procedure, catalog it; then call it with an 
EXEC statement whenever you want to use it. 


Cataloged and in-stream procedures are not checked for correct syntax until an EXEC 


statement that calls the procedure is checked for syntax. Therefore, a procedure can be tested 
only if an EXEC statement calls it. 
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Cataloging a Procedure: The library containing cataloged procedures is a partitioned data set. 

The system procedure library is SYS1.PROCLIB. The installation can have many more 2 
procedure libraries with different names. When a cataloged procedure is called, the calling step 

receives a copy of the procedure; therefore, a cataloged procedure can be used simultaneously 

by more than one job. 


Use the IEBUPDTE utility program to add a procedure to a library or to modify permanently 
a procedure in a catalog. If modifying, tell the system operator to delay any jobs that would 
use the procedure during modification. 


In a JES3 system, you can specify UPDATE on the JES3 //*MAIN statement to update a 
procedure library. 


The name of a cataloged procedure is its member name or alias in the library. 


Modifying Procedures J 


For its current execution, you can modify an in-stream or cataloged procedure by: 


e Overriding, nullifying, or adding EXEC statement parameters 
e Overriding, nullifying, or adding parameters to DD or OUTPUT JCL statements 
e Adding DD or OUTPUT JCL statements 


Invalid parameters in a procedure cannot be corrected through modification. Before making 
modifications, the system scans the original procedure statements for errors and issues error 
messages. 


Modifying EXEC Statement Parameters 


All keyword parameters on the calling EXEC statement affect the execution of the procedure, 
as follows: 


e All procedure statements: If a keyword parameter is to override the parameter or be added 
to every EXEC statement in the procedure, code the parameter in the usual way. For 
example, the ACCT parameter applies to all steps: 


//STEP1 EXEC PROC=RPT,ACCT=5670 


Note: A PARM parameter without a procstepname qualifier applies only to the first 
procedure step. A TIME parameter without a procstepname qualifier applies to the entire 
procedure and nullifies any TIME parameters on procedure step EXEC statements. 


If the keyword parameter is to nullify the parameter on every EXEC statement in the 
procedure, code it without a value following the equal sign. For example, the ACCT 
parameter is nullified in all steps: 


//STEP2 EXEC PROC=RPT,ACCT= 
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@ Only one procedure statement: If the keyword parameter is to override the parameter or be 
added to only one EXEC statement in the procedure, code .procstepname immediately 
following the keyword. The procstepname is the name field of the procedure EXEC 
statement containing the keyword parameter to be overridden. For example, the ACCT 
parameter applies to only step PSTEPWED: 


//STEP1 EXEC PROC=RPT,ACCT.PSTEPWED=5670 


If the keyword parameter is to nullify the parameter on only one EXEC statement in the 
procedure, code it with the procstepname. For example: 


//STEP2 EXEC PROC=RPT,ACCT.PSTEPTUE= 


The override, nullifying, or addition applies only to the current execution of the job step; the 
procedure itself is not changed. 


Rules for Coding Modifying EXEC Parameters: 

@e A PGM parameter cannot be modified. 

@ The calling EXEC statement can contain more than one change. 
e Modifying parameters should appear in the following order: 


— Parameters without a procstepname qualifier. 
— All parameters modifying the first step, then the second step, then the third step, etc. 


e The parameters for each step do not need to be coded in the same order as they appear on 
the procedure EXEC statement. 


e An entire overriding parameter must be coded, even though only part of the overridden 
parameter is being changed. 


Modifying OUTPUT JCL and DD Statements 


OUTPUT JCL and DD statements following the calling EXEC statement (1) override, nullify, 
or add parameters to OUTPUT JCL and DD statements in the procedure or (2) are added to 
the procedure. These changes affect only the current execution of the job step; the procedure 
itself is not changed. When an OUTPUT JCL statement is modified, the sysout data set is 
processed according to the parameters as modified by the overriding statement. 


In a procedure, to ensure that OUTPUT JCL and DD statements are overridden correctly by 
modifying statements, place the OUTPUT JCL statements before the DD statements in each 


step of the procedure. 


Location in the JCL: Place modifying OUTPUT JCL and DD statements in the following 
order, after the EXEC statement that calls the procedure: 


e@ For each procedure step in the invoked procedure: 


1. OQOverriding statements must appear in the same order as the statements that they are 
overriding. 


2. Added statements must appear after all overriding statements. 
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e For all procedure steps in the invoked procedure, place the modifying statements for each 
procedure step in the same order in which the procedure steps are specified. 


Coding an Overriding OUTPUT JCL or DD Statement: To override, nullify, or add parameters 
to a procedure OUTPUT JCL or DD statement, code in the name field of the overriding 
OUTPUT JCL or DD statement the name of the procedure step containing the overridden 
statement, followed by a period, followed by the name of the procedure OUTPUT JCL 
statement or the ddname of the procedure DD statement. 


//pstepname.name OUTPUT parameters 
//pstepname.ddname DD parameters 


Rules for Modifying OUTPUT JCL or DD Parameters: 
e@ The overriding statement can contain more than one change. 


@ Modifying parameters can appear in any order. 


e To nullify a parameter, do not code a value after the equal sign. 


e Ifyou are adding a parameter that is mutually exclusive with a parameter on the procedure 
statement, the procedure parameter is automatically nullified. 


e Anentire overriding parameter must be coded, even though only part of the overridden 
parameter is being changed. 


Rules for Modifying DD Parameters: 


e To nullify all parameters but the DCB parameter, code DUMMY on the overriding DD 
statement. 


@ Special rules apply when overriding a DCB parameter: 


— Code only the keyword subparameters to be changed; the other DCB subparameters 
remain unchanged. 


— Ifa positional subparameter is needed, code it, regardless of whether it appears in the 
overridden DCB parameter. If a positional subparameter is not needed or is to be 
nullified, omit it from the overriding DCB parameter. 


— To nullify the entire DCB parameter, nullify each subparameter appearing in the 
overridden DCB parameter. 


e To nullify a DUMMY parameter on the procedure statement, code a DSNAME parameter 
on the overriding DD statement and assign a name other than NULLFILE. 


Coding an Added OUTPUT JCL or DD Statement: To add OUTPUT JCL or DD statements 
to a procedure step, code in the name field of the added OUTPUT JCL or DD statement the 

name of the procedure step, followed by a period, followed by a name or ddname. The name 
must not appear on any procedure statement. 


//pstepname.name OUTPUT parameters 
//pstepname.ddname DD parameters 
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If you omit the procedure step name, the statement is added to the step named in the previous 
OUTPUT JCL or DD statement that named a step. If no previous statements named steps, the 
statement is added to the first step in the procedure. 


Added OUTPUT JCL and DD statements can contain symbolic parameters. If the statement is 
being added to the last procedure step, any symbolic parameters it contains must appear 
elsewhere in the procedure. 


In-stream Data for a Procedure: To supply a procedure step with data from the input stream, 
code a DD * or DD DATA statement in the calling step after the last overriding and added 
DD statement. The name field of this statement must contain the name of the procedure step, 
followed by a period, followed by a ddname. The ddname can be of your choosing or 
predefined in the procedure. If it is predefined, it appears ina DDNAME parameter on a 
procedure DD statement. For example: 


//PROCSTP1.ANYNAME DD * 
//PROCSTP2.PREDEFN DD DATA 


Rules for Modifying DD Statements in Concatenated Data Sets: 


e To override the first DD statement in a concatenation, code only one overriding DD 
statement. 


e To override any following DD statements in the concatenation, code an overriding DD 
statement for each concatenated DD statement. 


@ The overriding DD statements must be in the same order as the concatenated DD 
statements. 


@ Code a ddname on only the first overriding DD statement. Leave the ddname field blank 
on the following statements. 


@ To leave a concatenated statement unchanged, code its corresponding overriding DD 
statement with a blank operand field. 
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Examples of Procedures 


In the input stream: 
//JOBA JOB ACCT23,'G. HILL' 


//STEPA EXEC PROC=REP 
//PSTEP1.INDS DD * 


(data) 
/* ) 
In SYS1.PROCLIB member REP: 
PROC 


/ 
//PSTEP1 EXEC PGM=WRIT22 
//OUTDS DD SYSOUT=A 


In this example, the EXEC statement STEPA calls the cataloged procedure named REP and 
supplies in-stream data. The procedure executes a program named WRIT22. The output from 
the program will appear in the sysout class A data set. 


In the input stream: 


//JOB1 JOB ,'H.H. MORRILL' 
//ADD1 OUTPUT COPIES=2 
//STEPA EXEC PROC=P 
//PS1.OUTA OUTPUT  CONTROL=DOUBLE , COPIES=5 
//PS1.DSB DD OUTPUT=* .ADD1 . 
//PS1.DSE DD * 
(data) 

. : 

//PS2.OUTB OUTPUT DEFAULT=YES,DEST=STL 


In SYS1.PROCLIB member P: 


//PS1 EXEC PGM=R15 

//OUTA OUTPUT CONTROL=PROGRAM 

//DSA DD SYSOUT=C , OUTPUT=* .OUTA ) 
/ /DSB DD SYSOUT=D , OUTPUT=*.OUTA 

//PS2 EXEC PGM=T48 

//DSC DD SYSOUT=A 


In this example, added statements are: 


e ADDI, which is an OUTPUT JCL statement added at the job level. 
@e PS1.DSE, which is an in-stream data set added to procedure step PS1. 
e PS2.OUTB, which is a default OUTPUT JCL statement added to procedure step PS2. 


Overriding statements are: 
e PS1.OUTA, which changes the CONTROL parameter and adds a COPIES parameter to 


OUTPUT statement OUTA in procedure step PS1. 
e PS1.DSB, which changes the OUTPUT parameter on DD statement DSB in procedure step 


PS1. ) 
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//JOBB JOB ACCT23,'G. HILL' 

//STEPB EXEC PROC=WRIT35,COND.PSTEP3=(4,GT,PSTEP1) ,RD=R 
//PSTEP1.DD1 DD  VOLUME=SER=,UNIT=SYSDA,DISP=(NEW,CATALG) 
//PSTEP1.INDS DD * 


(data) 
yx ) 
//PSTEP2.DD3 DD DISP=(OLD, KEEP) 


//PSTEP3.DD5 DD DUMMY 
//PSTEP3.DD6 DD  DSNAME=A.B.C 


In SYS1.PROCLIB member WRIT35: 


// PROC 

//PSTEP1 EXEC PGM=WT1,TIME=(,50) 

//DD1 DD DSNAME=DATA1,DISP=(NEW,DELETE) , SPACE=(TRK,(10,2)), 
// UNIT=3330, VOL=SER=1095 

//DD2 DD DSNAME=&&WORK, UNIT=SYSDA,SPACE=(CYL,(10,1)), 
// DISP=(,PASS) 

//PSTEP2 EXEC PGM=WT2,TIME=(,30) 

//DD3 DD DSNAME=*.PSTEP1.DD2,DISP=(OLD,DELETE) 
//PSTEP3 EXEC PGM=UPDT,TIME=(,45) ,RD=RNC 

//DD4 DD sysouT=* 

//DD5 DD DSNAME=DATA3,UNIT=3340,DISP=OLD, 

// VOLUME=SER=335006 

//DDE DD DSNAME=QOUT,UNIT=3400-5 

//DD7 DD  SYSOUT=H 


In this example, EXEC statement STEPB calls the cataloged procedure WRIT35. The COND 
parameter is added to the EXEC statement for PSTEP3. The RD parameter is added to the 
EXEC statements for PSTEP1 and PSTEP2, and overrides the RD parameter on the EXEC 
statement for PSTEP3. 


In-stream DD statement PSTEP1.DD1 modifies DD statement DD1 in PSTEPI1; it nullifies the 
VOLUME#=SER parameter and overrides the UNIT and DISP parameters. Note that the 
parameters are not in the same order in the overriding and overridden statements. 


In-stream DD statement PSTEP1.INDS is added to PSTEP1, supplying in-stream data to be 
read by program WT1. 


In-stream DD statement PSTEP2.DD3 modifies DD statement DD3 in PSTEP2; it overrides 
the DISP parameter. Note that the entire parameter is coded, even though only the second 
subparameter is being changed. 


In-stream DD statement PSTEP3.DD5 nullifies DD statement DD5 in PSTEP3. However, DD 
statement DD5 will be checked for correct syntax. 


In-stream DD statement PSTEP3.DD6 modifies DD statement DD6 in PSTEP3; it overrides 
the DSNAME parameter. 


Note that procedure DD statements DD2, DD4, and DD7 were not modified. 
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Symbolic Parameters 


In order to be modified easily, the JCL statements in cataloged and in-stream procedures can 
contain symbolic parameters. A symbolic parameter can stand as a symbol for a parameter, a 
subparameter, or a value, that is, for any information in the parameter field of a procedure 
statement. 


Purpose of Symbolic Parameters: Any parameter, subparameter, or value in a procedure that 
can vary each time the procedure is called is a good candidate to be coded as a symbolic 
parameter. For example, if a job step is charged to different account numbers each time the 
procedure is executed, code the ACCT parameter on the EXEC statement as one or more 
symbolic parameters. For example: 


ACCT=&ALLNOS 
ACCT=&FIRST&SECOND&THIRD 


Coding Symbolic Parameters J 


Where: Code symbolic parameters on statements in a cataloged or in-stream procedure. You 
can also code symbolic parameters on DD statements being added to a procedure. However, 
on a DD statement being added to the last step of a procedure, do not use symbolic parameters 
that are not used previously in the procedure. 


The records in an in-stream data set that are defined by the DD * or DATA parameter are not 
processed as JCL statements. Therefore, values are not substituted for any symbolic parameters 


in these records. ) 


Syntax: A symbolic parameter consists of an ampersand (&) followed by a name, which is | 
through 7 alphanumeric and national ($, #, @) characters. The first character must be 
alphabetic or national. For example, DEST =&LOC on a DD or OUTPUT JCL statement. 


Words Prohibited as Names in Symbolic Parameters: EXEC statement parameter and 
subparameter keywords cannot be used as the name in a symbolic parameter. For example, do 
not code &£REGION = 200K or REGION = &REGION; correctly code REGION = &SIZE. 


In a procedure started by a START command from the operator console, do not use as 
symbolic parameters: 


DD statement keywords 
AFF 

SEP 

SPLIT 

SUBALLOC 


Symbolic Parameters Enclosed in Apostrophes: If a symbolic parameter is enclosed in 
apostrophes, correct substitution will occur only if the enclosed symbolic parameter is 
immediately preceded by a symbolic parameter that is not enclosed in apostrophes. For 
example, both A and B will be substituted correctly in: 


//DD1 DD &A'&B'!,DISP=OLD 
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Symbolic Parameter before Fixed Code: A period is required after a symbolic parameter when 
the following code does not vary and begins with: 


e An alphanumeric or national character ($, #, @) 
e A period 


The system recognizes the period as a delimiter: the period does not appear after the symbolic 
parameter is assigned a value or nullified. 


For example, if the first part of the data set name varies and the last does not, MONDATA, 
TUESDATA, etc., code: 


DSNAME=&DAY.DATA 


Code two consecutive periods (..) if a period should follow the symbolic parameter. For 
example, code &DEPT..POK when the desired value is D58.POK and DEPT =DS58 is the value 
assignment. 


Symbolic Parameter for Positional Parameter: When a symbolic parameter is a positional 
parameter followed by other parameters in the statement, the symbolic parameter should be 
followed by a period instead of a comma. For example: 


//DS1 DD &POSPARM.DSNAME=ATLAS , DISP=OLD 


If &POSPARM is nullified, the statement appears as: 


//DS1 DD DSNAME=ATLAS , DISP=OLD 


When assigning a value to £POSPARM, include the comma: 


POSPARM='DUMMY, ' 


Symbolic Parameter after Fixed Code: When a symbolic parameter is placed after information 
that does not vary, the system recognizes the symbolic parameter when it encounters the 
ampersand. For example: 


DSNAME=LIBRARY ( &MEMBER ) 
DSNAME=USERLIB. &LEVEL 


Two or More Symbolic Parameters: Code two or more symbolic parameters in succession 
without including a comma. For example: 


PARM=& DECK&CODE 


If the value should contain a comma, include a comma in the value assigned to the symbolic 
parameter. 


Multiple Symbolic Parameters: The same symbolic parameter can appear more than once ina 
procedure, as long as the value assigned to the symbolic parameter is the same throughout the 
procedure. Therefore, &DEPT can appear several times in a procedure, if the department 
number is always to be the same. 
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Uniform Symbolic Names in an Installation: The names for symbolic parameters should be 
consistent in all the cataloged and in-stream procedures at an installation. For example, every 
time a department number is to be assigned to a symbolic parameter in any procedure in the 
installation, the symbolic parameter could be named &DEPT. Different procedures could 
contain ACCT = (43877,&DEPT) and DSNAME=LIBRARY.&DEPT..TALLY. The 
installation can tell all programmers the meaning of all the “standard” symbolic names. 


Assigning Values to and Nullifying Symbolic Parameters 


For each use of a procedure, all symbolic parameters must be assigned a value or be nullified. 
Any not assigned a value or nullified remain as coded in the JCL and may cause errors when 
the procedure is executed. To assign a value to or nullify a symbolic parameter, code the value 
on one or both of the following: 


e The EXEC statement that calls the procedure. All symbolic parameters on the EXEC 
statement must appear in the procedure. 


e The PROC statement that must begin an in-stream procedure and can begin a cataloged » 
procedure. 


The symbolic parameters can be coded in any order on the PROC and EXEC statements. 


Multiple Values: Ifa value is assigned and/or nullified on both statements, the value on the 
EXEC statement overrides the value on the PROC statement. 


Only one value can be assigned to each symbolic parameter used in a procedure; if you assign 
or nullify the value of a symbolic parameter more than once, only the first value is used and | ) 
that value is substituted wherever the symbolic parameter occurs. 


Assigning Default Values to Symbolic Parameters: On the PROC statement, you should assign 
default values to all symbolic parameters in a procedure. The default will be used if a value is 
not assigned on the calling EXEC statement. 


Assigning a Value to a Symbolic Parameter 


To assign a value to symbolic parameter, code: ) 


symbolic-parameter=value 
Do not code the ampersand that identifies the symbolic parameter in the procedure. 


For example, if the symbolic parameter UNIT = & NUMBER appears on a DD statement in the 
procedure, code NUMBER = value on the PROC or EXEC statement. 


Length of Assigned Value: The value cannot be continued onto another statement. 


The length of the value you assign, combined with the length of all parameters and delimiters in 
the parameter field of the single procedure statement containing the symbolic parameter, cannot 
exceed 120 characters. For example, if a procedure contains: 


//DD1 DD DSNAME=&A,DISP=(,PASS) ,UNIT=3350, 
J / VOLUME=SER=25143,SPACE=(CYL, (10,10) , ,CONTIG) 
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The value assigned to &A must not be longer than 96 characters because the rest of the 
parameter field on that statement is 24 characters. Note that the length of the parameter field 
on the continuation statement is not considered. 


Special Characters in the Assigned Value: If the value contains special characters, enclose the 
value in apostrophes. The enclosing apostrophes are not considered part of the value. If the 
special characters include apostrophes, code each apostrophe as two consecutive apostrophes. 
For example, LOC =’O” HARE’. 


Nullifying a Symbolic Parameter 


To nullify a symbolic parameter, code: 


symbolic-parameter= 


Do not code the ampersand that identifies the symbolic parameter in the procedure. Do not code a 
value after the equal sign. Do not code literal blanks, that is, VALUE=’ ’, to nullify a 
symbolic parameter. 


For example, if the symbolic parameter UNIT =&NUMBER appears on a DD statement in a 
procedure, code one of the following to nullify it: 


//CALLER EXEC PROC=ABC,NUMBER=,ACCT=DID58 
// PROC NUMBER=,LOC=POK 


If you nullify a symbolic parameter on the calling EXEC statement, it is nullified, even though 
the procedure’s PROC statement contains a default value. 


A symbolic parameter that is last on a statement that is being continued cannot be nullified; it 
must be assigned a value. An attempt to nullify such a parameter results in a JCL error. 


Cautions about Leading and Trailing Commas: When a symbolic parameter is nullified, a 
delimiter, such as a leading or trailing comma, is not removed. In some cases, the remaining 
comma is needed; in others, it will be a syntax error. 


When Symbolic Parameter is Positional 
If a symbolic parameter is a positional parameter, a comma must remain to indicate its 
omission if another positional parameter follows. In this case, code a comma before and 
after the symbolic parameter; the needed commas will remain after nullification. For 
example, & NUMBER for the unit count: 


UNIT= (3350, &NUMBER, DEFER) 


When &NUMBER is nullified, the parameter correctly becomes: 


UNIT=(3350,,DEFER) 


When Symbolic Parameter is Not Positional 
If a symbolic parameter is not a positional parameter, a comma must not remain if it is 
omitted. In this case, do not code a comma before the symbolic parameter; no commas 
will remain after nullification. For example, serial numbers in the VOLUME=SER 
parameter: 


VOLUME=SER= ( &FIRST&SECOND) 
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If either of the symbolic parameters is nullified, a leading or trailing comma will not 
remain. If you nullify &FIRST and assign 222222 for SECOND or if you nullify 
&SECOND and assign 111111 for &FIRST, the parameter correctly becomes: 


VOLUME=SER= (222222) 
VOLUME=SER=(111111) 


Code a comma when you assign a value to the symbolic parameter and a comma is needed. 
For example: 


//CALLER EXEC PROC=ABC,FIRST=111111,SECOND=' ,222222' 


Because the comma is a special character, enclose the value in apostrophes. 


Examples of Symbolic Parameters 


JOBA JOB ... } 
//INSTREAM PROC LOC=POK 
//PSTEP EXEC PGM=WRITER 
//DSA DD SYSOUT=A,DEST=&LOC 
// PEND 
//CALLER EXEC PROC=INSTREAM, LOC=NYC 
// 


In this example of an in-stream procedure, the symbolic parameter &LOC is given a default 
value of POK on the PROC statement. Then it is given a current execution value of NYC on 


the calling EXEC statement. 
ee OC OO oO ed 
//JOBB JOB ... 

//INSTREAM PROC LOC=POK,NUMBER=3350 

//PSTEP EXEC ... 

//PIN DD DSNAME=REPORT , DISP=(OLD, KEEP) , UNIT=&NUMBER 

//POUT DD SYSOUT=A , DEST=&LOC 


// PEND 
/ /CALLER EXEC PROC=INSTREAM , NUMBER=, LOC=STL 
//PSTEP.INDATA DD * 


(data) . 
/* J 


This code nullifies the symbolic parameter €NUMBER. The calling EXEC statement 
assignment of STL for symbolic parameter &LOC overrides the PROC statement assignment of 
POK. 
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This example illustrates execution of an in-stream procedure to test symbolic parameters before 
placing the procedure in a procedure library. The in-stream procedure named TESTPROC is: 


//TESTPROC PROC A=IMB406,B=ABLE,C=3330,D=WXYZ1, 


// E=OLD,F=TRK,G='10,10,1' 

//STEP EXEC PGM=&A 

//DD1 DD DSNAME=&B,UNIT=&C,VOLUME=SER=&D,DISP=&E, 
// SPACE=(&F, (&G) ) 

// PEND 


To execute this in-stream procedure and override &A with IEFBR14, &B with BAKER, and 
&E with (NEW, KEEP) but leave the other parameters the same, call the in-stream procedure 
with: 


//CALLER1 EXEC PROC=TESTPROC,A=IEFBR14,B=BAKER,E='(NEW,KEEP) ' 


After the symbolic substitution, the statements are: 
//STEP EXEC PGM=IEFBR14 


//DDl1 DD DSNAME=BAKER, UNIT=3330,VOLUME=SER=WXYZ1, 
// DISP=(NEW,KEEP) , SPACE=(TRK,(10,10,1)) 


To execute the in-stream procedure in the previous example and change DD1 to resemble a 
temporary scratch space, code the following statement: 


//CALLER2 EXEC PROC=TESTPROC ,A=IEFBR14,B=,C=3350,D=,E= 


After the symbolic substitution, the statements are: 


//STEP EXEC PGM=IEFBR14 
//DD1 DD DSNAME=,UNIT=3350,VOLUME=SER=,DISP=,SPACE=(TRK, (10,10,1)) 
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Job Log 


Chapter 6. Job Control Statements on the Output Listing 


Use the JOB statement MSGLEVEL parameter to request that job control statements be 
printed in the job log output listing. Code MSGLEVEL =(1,1) to receive the maximum 
amount of information, in the following order: 


e JES messages and job statistics. 
e All job control statements in the input stream and procedures. 
e Messages about job control statements. 


e JES and operator messages about the job’s processing: allocation of devices and volumes, 
execution and termination of job steps and the job, and disposition of data sets. 


Statements in Listing: To identify the source and type of each statement, the system prints 
certain characters in columns | and 2 or 1, 2, and 3 of the listing. These identifying characters 
are explained in Figure 6-1 on page 6-2. The listing shows all procedure statements as they 
appear in the cataloged procedure; the listing does not show parameter substitutions and 
overrides on the statement itself. 


Symbolic Parameters: The job log listing shows the symbolic parameters in procedure 
statements. The values assigned to the parameters are given in IEF653I messages. These 
messages appear immediately after each statement that contains symbolic parameters. 


EXEC Overriding Parameters: A procedure EXEC statement appears in the job log listing 
exactly as it appears in the procedure. Overridden parameters must be shown by the program 
being executed: 


e For the EXEC statement that executes the assembler program, the Diagnostic Cross 
Reference and Assembler Summary produced by the assembler program shows the 


overriding parameters. 


@ For the EXEC statement that executes the linkage editor, the linkage editor listing shows 
the overriding parameters. 
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Columns 
1, 2, and 3 


Source and Type of Statement 


Job Control Statements in the Input Stream 


JCL statement 


Job control statement that is not a JCL comment statement 


| but one that the system considers to contain only comments 


| JES2 statement 


| JES3 statement 


JCL comment statement 


DD statement that was not overridden and all other JCL 
statements, except the JCL comment statement. Each statement 
appears in the listing exactly as it appears in the procedure. 


DD statement that was overridden (preceded by the overriding 
DD statement) 


Job control statement that is not a JCL comment statement 
but one that the system considers to contain only comments 


JCL comment statement 


In-Stream Procedure Statements 


DD statement that was not overridden and all other JCL 
statements, except the JCL comment statement. Each statement 
appears in the listing exactly as it appears in the procedure. 


DD statement that was overridden (preceded by the overriding 
DD statement) 


Job control statement that is not a JCL comment statement 
but one that the system considers to contain only comments 


JCL comment statement 


Identification of Statements in Job Log 
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Chapter 7. JCL Command Statement 


Purpose: Use the JCL command statement to enter.an MVS operator command through the 
input stream. 


The JCL command statement is supported only on JES2 systems. 


Note: To enter a JES2 command, use the JES2 command statement described on page 21-2. 
To enter a JES3 command, use the JES3 command statement described on page 22-3. 


The system usually executes an in-stream command as soon as it is read. Therefore, the 
command will not be synchronized with the execution of any job or step in the input stream. 
To synchronize a command with the job processing, tell the operator the commands you want 
and when they should be issued, and let the operator enter them from the console. 


The system processes each command according to installation options for both the input device 
from which the job was read, and the job class. 


References: For more information on MVS commands and for descriptions of their 
parameters, see System Commands. 


Syntax: 


// command [parameter] [comments] 


The command statement consists of the characters // in columns | and 2 and three fields: 
operation (command), parameter, and comments. 


Do not continue a command statement. 
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Operation Field 
The operation field contains the MVS operator command and is coded as follows: J 
e Precede and follow the command with one or more blanks. It can begin in any column. 


@ Code the command or a valid abbreviation for the command. The following MVS 
operator commands can be entered through the input stream. 


CANCEL MONITOR SEND STOP 
CHNGDUMP MOUNT SET STOPMN 
DISPLAY PAGEADD SETDMN UNLOAD 
HOLD RELEASE SLIP VARY 

LOG REPLY START WRITELOG 
MODIFY RESET 


Parameter Field 


Code any required parameters. When more than one parameter is coded, separate them with i 
commas. 


Comments Field 


The comments field follows the parameter field after at least one intervening blank. 


Location in the JCL 


A command statement can appear anywhere after a JOB statement and before the end of the 
job. If a command statement appears between jobs, it is ignored. A command statement 
should not be placed before the first JOB statement in an input stream. 


If a command statement contains errors, it is not executed. If the erroneous statement is 
between two jobs in the input stream, the system does not issue a message to indicate that the 
command is not executed. 


Example of the Command Statement 


// DISPLAY TS,LIST 


In response to this command statement, the system displays the number and userid of all active 
time-sharing users of the system. 
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Chapter 8. Comment Statement 


Purpose: Use the comment statement to enter a comment on the output listing. The comment 
statement is used primarily to document a job and its resource requirements. 


Syntax: 


//*comments 


The comment statement consists of the characters //* in columns 1, 2, and 3 and one field: 
comments. 


Code the comments in columns 4 through 80. The comments field does not need to be 
preceded or followed by blanks. (In a JES3 system, do not use a JES3 keyword as the first 
word in column 4 of the comment field, or the comment might be taken for a JES3 
statement.) 


Do not continue a comment statement using continuation conventions. Instead, code 
additional comment statements. 


Location in the JCL 


Place a comment statement anywhere after the JOB statement. You can place a comment 
statement between continuations of JCL statements. 


Listing of Comments Statements 


Use the MSGLEVEL parameter on the JOB statement to request that the job log output listing 
contain all the JCL statements for your job. On this listing, comment statements have *** in 
columns 1, 2, and 3. 


Examples of the Comment Statement 


//* THE COMMENT STATEMENT CANNOT BE CONTINUED, 

//* BUT IF YOU HAVE A LOT TO SAY, YOU CAN FOLLOW A 
//* COMMENT STATEMENT WITH MORE COMMENT 

//* STATEMENTS. 
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Chapter 9. CNTL Statement 


Purpose: Use the CNTL statement to mark the beginning of program control statements in the 
input stream. Program control statements specify control information for a subsystem. The 
program control statements are ended by an ENDCNTL statement and are called a 
CNTL/ENDCNTL group. 


The DD statement that defines a data set to be processed by a subsystem must refer to the 
CNTL statement in order for the subsystem to use the program control statements in processing 
the data set. 

References: The program control statements are documented in the publications for the 
subsystems. For example, see JBM 3800 Printing Subsystem Models 3 and 8 Programmer's 


Guide for information on program control statements for the Print Services Facility (PSF). 


Syntax: 


//iabel CNTL [ * comments] 


The CNTL statement consists of the characters // in columns 1 and 2 and four fields: label, 
operation (CNTL), parameter (*), and comments. The * parameter is required only when 
comments follow. 


Label Field 
Code a label on every CNTL statement, as follows: 


Each label must be unique within the job. 

The label must begin in column 3. 

The label is 1 through 8 alphanumeric or national ($, #, @) characters. 
The first character must be alphabetic or national ($, #, @) 

The label must be followed by at least one blank. 


Operation Field 


The operation field consists of the characters CNTL and must be preceded and followed by at 
least one blank. It can begin in any column. 
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Parameter Field 
The parameter field contains only an asterisk. When present, the asterisk must be preceded and 


followed by at least one blank. The asterisk is required only when the statement contains 
comments. 


Comments Field 


The comments field follows the asterisk after at least one intervening blank. 


Location in the JCL 


A CNTL statement must appear before the DD statement that refers to it. The CNTL and its 
referencing DD statement must be in the same job step or in the same cataloged or in-stream 
procedure step. A CNTL statement can be in a procedure and the referencing DD statement 
can be in the calling job step, but not vice versa. 


Program Control Statements 
Program control statements supply control information for a subsystem. A subsystem can 
require one or more program control statements. The one or more statements must be 
immediately preceded by a CNTL statement and immediately followed by an ENDCNTL 
Statement. 


Do not code JCL statements within a program control group. 


Program Control Statements in Procedures 


You can code symbolic parameters on program control statements in a cataloged or in-stream 
procedure. 


You can override parameters on program control statements in a procedure. Follow the rules 


used for overriding DD statement parameters in a procedure. For more information, see 
“Modifying OUTPUT JCL and DD Statements” on page 5-3. 


Example of the CNTL Statement 


//STEP1 EXEC PGM=PRINT 

//ALPHA CNTL * PROGRAM CONTROL STATEMENT FOLLOWS 
//PRGCNTL  PRINTDEV BUFNO=20,PIMSG=YES , DATACK=BLOCK 

/ /OMEGA ENDCNTL 

//AGAR DD UNIT=3800-3,CNTL=*.ALPHA 


The PSF subsystem uses the BUFNO, PIMSG, and DATACK options of the PRINTDEV 
control statement to print the data set for DD statement AGAR on a 3800 model 3. 
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Chapter 10. DD Statement 


Purpose: Use the DD (data definition) statement to describe a data set and to specify the input 
and output resources needed for the data set. 


The parameters you can specify for data set definition are arranged alphabetically in the 
following pages. 


References: For information about the JES initialization parameters that provide installation 
defaults, see SPL: JES2 Initialization and Tuning and SPL: JES3 Initialization and Tuning. 


Syntax: 


//|\daddname DD [positional-parameter][,keyword-parameter]... 
procstepname.ddname| [comments] 


//\dadname DD 
procstepname.ddname 


The DD statement consists of the characters // in columns | and 2 and four fields: name, operation 
(DD), parameter, and comments. Do not code comments if the parameter field is blank. 


A DD statement is required for each data set. 

The maximum number of DD statements per job step are: 
3273, in a JES2 system. Note that the limit of 3273 is based on the number of single DD 
statements allowed for a TIOT (task input output table) control block size of 32K. This limit can 
be different depending on the installation-defined TIOT size. 


Determined by the installation, in a JES3 system. 


Name Field 
When specified, code a ddname as follows: 


e Each ddname should be unique within the job step. If duplicate ddnames appear in a job 
step, processing is as follows: 


— Ina JES2 system: The system performs device and space allocation and disposition 


processing for both DD statements; however, it directs all references to the first DD 
statement in the step. 
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— Ina JES3 system: If both DD statements request JES3 or jointly-managed devices, the 
system cancels the job during JES3 interpretation. If only one or neither DD statement 
requests a JES3 or jointly-managed device, the system performs device and space 
allocation processing for both DD statements; however, it directs all references to the 
first DD statement in the step. 


@ The ddname must begin in column 3. 

e@ The ddname is 1 through 8 alphanumeric or national ($, #, @) characters. 
e@ The first character must be alphabetic or national ($, #, @). 

@ The ddname must be followed by at least one blank. 

Omitting the ddname: Do not code a ddname in two cases: 


@ The DD statement defines a data set that is concatenated to the data set of the preceding 


DD statement. | ) 


@ The DD statement is the second or third consecutive DD statement for an indexed 
sequential data set. 


ddname when Overriding or Adding to Procedures: Ona DD statement that overrides a 

procedure DD statement, code in the name field the name of the procedure step containing the 

overridden DD statement, followed by a period, followed by the ddname of the procedure DD 

statement to be overridden. On a DD statement that is to be added to a procedure, code in the 

name field the name of the procedure step, followed by a period, followed by a ddname of your 

choosing. For example: J 


//PROCSTP1.DDA DD parameters 


Special ddnames: Use the following special ddnames only when you want to use the facilities 
these names represent to the system. These facilities are explained in Chapter 11, “Special DD 
Statements.” 


JOBCAT SYSCHK 
JOBLIB SYSCKEOV 
STEPCAT SYSIN 
STEPLIB SYSMDUMP 
SYSABEND SYSUDUMP 


The following ddnames have special meaning to JES3; do not use them on a DD statement in a 
JES3 system. 


JCBIN JESJCL JSICATLG 
JCBLOCK JESMSG J3JBINFO 
JCBTAB JOURNAL J3SCINFO 
JCLIN JST 

JESInnnon SYSMSG 
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Operation Field 


C 


The operation field consists of the characters DD and must be preceded and followed by at 
least one blank. It can begin in any column. 


Parameter Field 


A DD statement has two kinds of parameters: positional and keyword. All parameters are 
optional. However, leave the parameter field blank only on a DD statement that overrides a 
DD statement for a concatenated data set in a cataloged or in-stream procedure. 


Positional Parameters: A DD statement can contain one positional parameter. If coded, this 
positional parameter must precede all keyword parameters. 


( POSITIONAL PARAMETERS VALUES PURPOSE 


ea *: for data sets containing no JCL Begins an in-stream data set. 
DATA 


DATA: for data sets containing JCL 
See page 10-13 or 10-39 


DUMMY Specifies no space allocation, no 
disposition processing, and, for 
BSAM and QSAM, no I/O. 

See page 10-86 


DYNAM (Parameter is supported to 
provide compatibility with 
previous systems.) 

See page 10-89 


Keyword Parameters: A DD statement can contain the following keyword parameters. You 
can code any of the keyword parameters in any order in the parameter field after a positional 
parameter, if coded. 


Do not use DD statement keywords as symbolic parameters in procedures to be started by a 
( START command from the operator console. 


KEYWORD PARAMETERS VALUES PURPOSE 


ACCODE = access-code access-code: 1 - 8 characters, first must Specifies or changes an 


be upper case A - Z accessibility code for an 
ISO/ANSI/FIPS Version 3 tape 
output data set. 


See page 10-16 
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KEYWORD PARAMETERS VALUES PURPOSE | 


AMP =(subparameter) 
AMP = (‘subparameter[,subparameter]...’) 


see VSAM Administration Guide Completes information in an 
access method contro] block 
(ACB) for a VSAM data set. 


subparameters: 
AMORG 
BUFND = number 
BUFNI= number 
BUFSP = bytes 
CROPS = ( RCK 
NCK 
NRE 
NRC 


] 
L 


OPTCD= 


IL 


RECFM= [{F 

FB 

Vv 

VB 
STRNO = number 
SYNAD = modulename 
TRACE 


See page 10-18 


With SMS only: 


Specifies a record request and 
the quantity of primary and 
secondary space specified 

on the SPACE parameter. 


U: space specified in records 
K: space specified in thousands of records 
M: space specified in millions of records 


AVGREC= 


See page 10-24 


BURST = YES or Y: burster-trimmer-stacker Directs output to a stacker 


YES 
Y NO or N: continuous forms stacker on a 3800 Printing Subsystem. 


NO 
N 


See page 10-26 


table-name 1 - 4 table-name subparameters: Names character-arrangement 
CHARS = | (table-name[,table-name]...) 1 - 4 alphanumeric or $, #, @ characters tables for printing on a 3800 
DUMP DUMP: 204-character print lines on 3800 Printing Subsystem. Requests a 


DUMP, table-name]...) high-density dump on a 
SYSABEND or SYSUDUMP 
DD statement. 


See page 10-28 


CHKPT=EOV 


Requests a checkpoint at each 
end-of-volume, except the last. 


See page 10-31 


* label 
* stepname. label 
* stepname.procstepname. label 


label: names CNTL statement 
stepname: CNTL in named step 
procstepname: step in named procedure 


Causes the system to execute 
statements following an earlier 
CNTL statement. 


CNTL= 


See page 10-33 


nnn (JES2): 1 - 255 
nnn (JES3): 1 - 254 
1 - 8 group-values (JES2): 1 - 255 
1 - 8 group values (JES3): 1 - 254 


Specifies number of copies 
printed. For a 3800 Printing 
Subsystem, can instead specify 
number of copies of each page 
printed before the next page is 
printed. 


COPIES = 
(,group-value[,group-value]...)) 


nnn 
(nnn,(group-value[,group-value]...)) 


See page 10-35 
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KEYWORD PARAMETERS VALUES PURPOSE 


With SMS only: 
DATACLAS = data-class-name 


See page 10-42 


DCB = (subparameter[,subparameter]...) 


DCB= 


dsname 

* ddname 

* stepname.ddname 

* stepname.procstepname.ddname 


[,subparameter]... 


See page 10-44 


DDNAME=ddname 


See page 10-59 


DEST = destination 


destination (JES2): 
LOCAL 
name 
Nonon 
NonRmmmm to NannnRmm 
Rnonnn or RMnnnn or RMTnoonn 
Unnnn 
(node, userid) 


destination (JES3): 
ANYLOCAL 
device-name 
device-number 
group-name 
nodename 
(node,userid) 


See page 10-63 


DISP = status 
DISP = ((status][,normal-termination-disp] 
[,abnormal-termination-disp]) 


See page 10-67 


DLM =delimiter 


See page 10-77 


data-class-name: installation-defined name 
of a data class 


subparameter: see tables in DCB parameter 
description 


dsname: copy DCB information from named 
cataloged data set 

* ddname: copy DCB parameter from named 
earlier DD statement 

stepname: DD in named step 

procstepname: step in named procedure 


ddname: names later DD statement 


LOCAL or ANYLOCAL: local device 
name: named local or remote device 
Nnnnn: node (1 - 1000) 
NnRm: node (1 - 1000) and remote work 
station (1 - 9999); 6 digits maximum 
for n and m combined 
Rnnonn or RMnnonn or RMTnnnon: remote 
terminal (1 - 9999) 
Unnnn: local terminal (1 - 9999) 
(node, userid): node (1 - 8 alphanumeric 
or $, #, @ characters) and TSO userid 
(1 - 7 alphanumeric or $, #, @ characters) 
or VM userid (1 - 8 alphanumeric or 
$, #, @ characters) 
device-number: 3-number address 
device-name: local device (1 - 8 alphanumeric 
or $, #, @ characters) 
group-name: | or more local devices 
or remote stations (1 - 8 alphanumeric or 
$, #, @ characters) 


/ nodename: node (1 - 8 alphanumeric or 


$,#, @ characters) 


status: NEW, OLD, SHR (for shared), 
MOD (for data set to be modified) 

normal-termination-disp: DELETE, KEEP, 
PASS, CATLG, or UNCATLG 

abnormal-termination-disp: DELETE, 
KEEP, CATLG, or UNCATLG 


delimiter: 2 characters 


Specifies the data class for a 
new data set. 


Completes information in data 
control block (DCB). 


Postpones defining the data set 
until later in same step: on a 
DD statement in the calling step 
or in a procedure called by the 
step. 


Sends a sysout data set to the 
specified destination. 


Describes the status of the data 
set and tells the system to do the 
following with the data set after 
normal or abnormal termination 
of the step or job: delete or keep 
it on its volume(s), pass it to a 
later step, or add it to or 
remove it from the catalog. 


Terminates an in-stream data 
set. 
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KEYWORD PARAMETERS VALUES PURPOSE 


| 


DSID= | id | 
(id [VD 


See page 10-79 


dsname 
dsname(member-name) 
dsname(generation-number) 
DSNAME}| = 
DSN 


dsname(area-name) 

&&dsname 
&&dsname(member-name) 
&&dsname(area-name) 

* ddname 

* stepname.ddname 

* stepname.procstepname.ddname 
NULLFILE 


See page 10-81 


EXPDT= | yyddd 
yyyy/ddd 


See page 10-90 


FCB =| fcb-name 
(fcb-name {,ALIGN | ) 
[VERIFY | 


See page 10-92 


FLASH = § (overlay-name[,count]) 


overlay-name 
NONE 


See page 10-96 


FREE= ] END 
CLOSE 


See page 10-99 


KEYLEN = bytes 


See page 10-104 


With SMS only: 
KEYOFF = offset-to-key 


See page 10-106 


HOLD= [{ YES 
Y 


NO 
N 


See page 10-102 
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id: 1 - 8 characters 
V: label was verified (only on a SYSIN 
DD statement) 


unqualified dsname: | - 8 alphanumeric or 
$, #, @ characters, -, +0 

qualified dsname: multiple names joined by 
periods 

member-name: member in PDS 

generation-number: 0 or signed integer 

area-name: INDEX, PRIME, or OVFLOW 
area in indexed sequential data set 

* ddname: copy dsname from earlier DD 

stepname: DD in named step 

procstepname: step in named procedure 

NULLFILE: dummy data set 


yyddd: expiration date 

(yy: 2-digit year, ddd: day 001-366) 
yyyy/ddd: expiration date 

(yyyy: 4-digit year, ddd: day 001-366) 


fcb-name: | - 4 alphanumeric or $, #, @ 
characters 

ALIGN: operator check forms alignment 

VERIFY: operator verify FCB image 


overlay-name: forms overlay frame (1 - 4 

alphanumeric or $, #, @ characters) 
count: copies with overlay (0 - 255) 
NONE: suppresses flashing 


END: deallocate at end of step 
CLOSE: deallocate when data set is closed 


bytes: number of bytes (1-255 for key- 
sequenced (KS), 0-255 for sequential (PS) 
or partitioned (PO)) 


offset-to-key: position of key (0 to difference 
of LRECL and KEYLEN minus 1) 


YES or Y: holds this sysout data set 
NO or N: allows normal processing for this 
sysout data set’s output class 


Identifies a data set on a 
diskette of a 3540 Diskette 
Input/Output Unit. 


Names the data set. 


Specifies an expiration date for 
the data set. 


Specifies FCB image, carriage 
control tape for 1403 Printer, or 
data-protection image for 3525 
Card Punch. 


For printing on a 3800 Printing 
Subsystem, indicates that the 
data set is to be printed with the 
named forms overlay and can 
specify how many copies are to 
be flashed. 


Specifies when to deallocate the 
resources for this data set. 


Specifies the length of the keys 
in the data set. 


Specifies the offset of the first 
byte of the record key. 


Tells the system to hold this 
sysout data set until released by 
the operator. 


DD 


KEYWORD PARAMETERS VALUES PURPOSE 


LABEL= 
[data-set-seq-no][,label-type] | ,PASSWORD 
,NOPWREAD 


Specifies information about a 
data set’s label, password, 
opening, expiration date, and, 


data-set-seq-no: data set position on tape 
volume (1 - 4 decimal digits) 
label-type: 


> 


AN ,RETPD = nnon 
OUT | | .EXPDT =, yyddd 
; yyyy/ddd 


See page 10-108 


With SMS only: 


LIKE = data-set-name 


See page 10-115 


LRECL = bytes 


See page 10-117 


With SMS only: 
MGMTCLAS = data-class-name 


See page 10-119 


MODIFY = | module-name 
(module-namef{,trc]) 


See page 10-121 
id 


MSVGP = | (id[,ddname]) 
SYSGROUP 


See page 10-123 


OUTLIM = number 
See page 10-126 


SL: IBM standard labels 
SUL: IBM standard and user labels 
AL: ISO/ANSI Version 1 and 
ISO/ANSI/FIPS Version 3 labels 
AUL: user labels and ISO/ANSI Version 1 
and ISO/ANSI/FIPS Version 3 labels 
NSL: nonstandard labels 
NL: no labels 
BLP: bypass label processing 
LTM: leading tapemark 
PASSWORD: password required to access 
data set 
NOPWREAD.: password required to change 
or delete data set 
IN: only read BSAM data set opened for 
INOUT or BDAM data set opened 
for UPDAT 
OUT: only write to BSAM data set opened 
for OUTIN or OUTINX 
RETPD = nnnn: retention period (nnnn: 1 - 4 
decimal digits) 
EXPDT = yyddd: expiration date (yy: 2-digit 
year, ddd: day 001 - 366) 
EXPDT = yyyy/ddd: expiration date 
(yyyy: 4-digit year, ddd: day 001 - 366) 


data-set-name: dsname of model data set 


bytes: length in bytes (1-32760 for PS or PO, 
1-32761 for KS, ES, or RR) 


data-class-name: installation-defined name 
of a data class 


module-name: 1 - 4 alphanumeric or 
$, #, @ characters 

trc: table-name in CHARS parameter 
(0 for first, 1 for second, 2 for third, 
and 3 for fourth table-name) 


id: group of mass storage volumes 
(1 - 8 alphanumeric or $, #, @ characters) 
ddname: allocates this data set to volume(s) 
other than those for DD statement ddname 
SYSGROUP: default group of mass storage 
volumes 


number: | - 16777215 logical records 
maximum 


for a tape data set, relative 
position on the volume. 


Specifies the attributes of a new 
data set. 


Specifies the length of the 
records in the data set. 


Specifies the management class 
for a new data set. 


Specifies a copy-modification 
module in SYS1.IMAGELIB to 
be used by JES to print the data 
set on a 3800 Printing 
Subsystem. 


Places the data set on a group 
of mass storage volumes on an 
MSS device. 


Limits the logical records in this 
sysout data set. 


Chapter 10. DD Statement 10-7 


DD 


KEYWORD PARAMETERS VALUES PURPOSE 


OUTPUT = | reference 
(reference[,reference]...) 


reference: 
* name 
* stepname.name 
* stepname.procstepname.name 


See page 10-128 


PROTECT = YES 


See page 10-132 


QNAME = procname[.tcamname] 


See page 10-135 


See page 10-141 


With SMS only: 


* ddname 
REFDD={ *.stepname.ddname 
* stepname.procstepname.ddname 


See page 10-143 


RETPD =nnnn 


See page 10-145 
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name: names earlier OUTPUT JCL statement 
stepname: OUTPUT JCL in named step 
procstepname: step in named procedure 


procname: names a TPROCESS macro 
that defines a destination queue for 


the messages 


tcamname: names a TCAM job or started task 


to process the messages 


Record format is: 
F: fixed length 
B: blocked 
S: spanned 
V: variable length 
U: undefined length 
Control characters are: 
A: ISO/ANSI code 
M: machine code 


Organization of records: 
KS: key-sequenced 
ES: entry-sequenced 
RR: relative record 
LS: linear space 


Referenced DD statement: 
ddname: unqualified name 
stepname: qualified by step name 
procstepname: step in procedure 


nnnn: number of days (0-9999) 


Associates this sysout data set 
with one or more OUTPUT 
JCL statements. 


Requests that RACE create a 
discrete profile to protect a data 
set on direct access or a tape 
volume. 


Indicates that this data set 
contains TCAM messages. 


Specifies the format and 
characteristics of the records 
in a data set. 


Specifies the organization of 
the records in a VSAM data 
set. 


Specifies the attributes of a 
new data set by referring to a 
previous DD statement. 


Specifies the retention period 
for a new data set. 


DD 


KEYWORD PARAMETERS VALUES PURPOSE 


With SMS only: 
SECMODEL = (profile-name[,GENERIC]) 


See page 10-147 


For system assignment of space: 


SPACE = 


TRK, 
CYL, 
blklgth, 


[primary | second-qty | 
reclgth, 


> 


ioe Fam [.ROUND] 


,CONTIG 
index | 


»MXIG 
LX 


? > 


> 


To request specific tracks: 


SPACE = 
ABSTR, | primary-qty,address | ,directory 
index 


To request directory blocks (with SMS only): 
SPACE = (,(,,directory)) 
See page 10-149 


With SMS only: 
STORCLAS = storage-class-name 


See page 10-156 


SUBSYS =| subsystem-name 
[,subsystem-parameter]... 


See page 10-158 


SYSOUT =class 
SYSOUT = 


[class] | ,writer-name ene | 


AINTRDR ,code-name 


> 


SYSOUT=* 
SYSOUT =(,) 


See page 10-161 


profile-name: name of model profile 
GENERIC: model is generic profile 


Specifies a RACF profile to 
be used for a new data set. 


TRK: allocation in tracks 
CYL: allocation in cylinders 
blklgth: allocation in average blocks, 


1 - 65535 

reclgth: allocation in average records (SMS) 

primary-qty: number of tracks, cylinders, or 
blocks to be allocated 

second-qty: additional tracks or cylinders to 
be allocated, if more are needed 

directory: number of 256-byte records for 
PDS directory 

index: tracks or cylinders for index of indexed 
sequential data set 

RLSE: release unused space when data set 
is closed 

CONTIG: contiguous primary allocation 


MXIG: allocation in largest available space 
(not supported for indexed sequential data 
sets) 

ALX: allocation of up to 5 separate 
contiguous primary quantities 

ROUND: allocation by block length rounded 
to integral cylinders 

ABSTR: allocation at the specified address 

address: track number of first track to be 
allocated 


Requests space for a new data 
set on direct access storage. 


Specifies the storage class for a 
new data set. 


storage-class-name: installation-defined name 
of a storage class 


subsystem-name: identifies the subsystem 
subsystem-parameter: specifies information 
for the subsystem 


Requests a subsystem to process 
this data set. 


class: A- Z,0-9 

writer-name: | - 8 alphanumeric or $, #, @ 
characters 

form-name: | - 4 alphanumeric or $, #, @ 
characters 

code-name: | - 4 alphanumeric or $, #, @ 
characters (JES2 only) 

*: same output class as MSGCLASS 
parameter on JOB statement 


Defines this data set as a sysout 
data set and (1) assigns it to an 
output class, (2) requests 
external writer to process it, 

(3) identifies print or punch 
forms, and (4) refers to the 
code-name of a JES2 
/*OUTPUT statement. 
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KEYWORD PARAMETERS VALUES PURPOSE 


TERM=TS 


In a foreground job, indicates 
that this data set is coming from 
or going to a TSO userid. In a 
batch job, indicates that this DD 
statement begins an in-stream 
data set. 


See page 10-168 


UCS= 
character-set-code 
(character-set-code 


character-set-code: | - 4 alphanumeric or Specifies universal character set, 
$, #, @ characters print train, or character- 

FOLD: operator load chain or train in fold arrangement table for a 3800 
mode Printing Subsystem. 

VERIFY: operator verify UCS image 


,FOLD 


> 


|, VERIFY]) 


See page 10-170 


device-number || ,unit-count 
device-type ,P [,DEFER] 
group-name ; 


device-number: 3-digit hexadecimal number Requests allocation to a specific 
device-type: machine type and model device, a type or group of 
group-name: 1 - 8 alphanumeric or $, #, @ devices, or the same device(s) as 
characters another data set. Also can 
unit-count: 1 - 59 specify how many devices and 
P: allocate same number of devices as volumes; deferred mounting. 
for parallel mount 
DEFER: defers mounting until open 
AFF = ddname: requests allocation of same 
devices as for DD statement ddname 


UNIT= 


UNIT = AFF = ddname 


See page 10-173 


VOLUME 
VOL 


PRIVATE: requests a private volume 

RETAIN: requests private tape volume remain 
mounted and unwound or requests public 
tape volume be retained at device 

volume-seq-no: begins processing with volume 

1 - 255 of existing multivolume data set 

volume-count: maximum volumes for output 
data set (1 - 255) 

serial-number subparameters (1 - 255): 
volume serial numbers (1 - 6 alphanumeric, 
$, #, @, or special characters) 

REF: copy volume serial numbers from 
another data set or earlier DD statement, 
or copy storage class for SMS-managed 
data sets 

dsname: from cataloged or passed data set 

ddname: from named earlier DD statement 

stepname: DD in named step 
procstepname: step in named procedure 


Identifies the volume(s) on 
which a data set resides or will 
reside. 


[PRIVATE] 


> 


,RETAIN | 


volume seqne | [,volume-count] 


bd 


SER = (serial-number[,serial-number]...) 
REF = dsname 
[,] | REF=*.ddname 
REF = *.stepname.ddname 
| REF = * stepname.procstepname.ddname 


REF = *.procstepname.ddname 


See page 10-178 
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DD 


Comments Field 


C The comments field follows the parameter field after at least one intervening blank. If you do 
not code any parameters on a DD statement, do not code any comments. 


Location in the JCL 


Most DD statements define data sets to be used in a job step, in a cataloged procedure step, or 
in an in-stream procedure step; these appear after the EXEC statement for the step. Some DD 
statements define data sets for the job, for example, the JOBLIB DD statement; these appear 
after the JOB statement and before the first EXEC statement. 


When Overriding or Adding to Procedures: Place DD statements that override, nullify, or add 
parameters immediately following the EXEC statement that calls the procedure. Place 
overriding and nullifying DD statements first, followed by all added DD statements. Last in 
the calling step are any DD * or DD DATA statements with their in-stream data. 


c To override more than one DD statement in a procedure, place the overriding DD statements 
in the same order as the overridden DD statements in the procedure. 


Concatenating Data Sets 


You can logically connect or concatenate sequential or partitioned input data sets for the 
duration of a job step. Each of the concatenated data sets can reside on a different volume. 
For details on concatenating data sets, see Data Administration Guide. 


C Coding a Concatenation: To concatenate data sets, omit the ddnames from all the DD 
statements except the first in the sequence. The data sets are processed in the same sequence as 
the DD statements defining them. 


Devices for Concatenated Data Sets: Concatenated data sets can reside on different devices and 

different types of devices. (This may require internal DCB modifications, see Data 

Administration Guide.) Also, do not concatenate data sets on direct access devices with 

Rotational Position Sensing (RPS) and data sets on non-RPS devices unless your application 
C can handle this situation. 


Block Sizes for Concatenated Data Sets: Concatenated data sets can have different block sizes 
as long as the data set with the largest block size appears first in the concatenation. (Note that 
you can state a value equal to the largest block size for BLKSIZE on the first DD statement, 
regardless of what the actual block size of this data set is. Also, certain data sets can be 
concatenated in any order of block size; these are (1) partitioned data sets, and (2) 
DASD-resident sequential data sets that are accessed by QSAM and use system-created 
buffers.) 


The system determines an optimum block size for you if you do not specify a block size. 
Logical Record Lengths for Concatenated Data Sets: Concatenated data sets can have different 
logical record lengths as long as the data set with the largest logical record length appears first 


in the concatenation. (Note that you can state a value equal to the largest logical record length 
for LRECL on the first DD statement, regardless of what the actual logical record length of 


( this data set is.) 
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DD 


References to Concatenated Data Sets: If you make a backward reference to a concatenation 
(using *.), the system obtains information only from the first data set defined in the sequence of ) 
DD statements. 


If you make a forward reference to a concatenation (using the DDNAME parameter), the 
system obtains information only from the first data set defined in the sequence of DD 
statements. 


If you issue an assembler RDJFCB macro instruction to a data set that is in a concatenation, 
the system reads the job file control block (JFCB) for only the first data set defined in the 
sequence of DD statements. 


Do Not Concatenate Data Sets to a DUMMY Data Set: If you define a data set using the 
DUMMY parameter, do not concatenate other data sets to it. When the processing program 
asks to read a dummy data set, the system takes an end-of-data set exit immediately and 
ignores any data set that might be concatenated to the dummy. 


Examples of DD Statements and ddnames J 


//MYDS DD DSNAME=REPORT 
//B DD DSNAME=FILE 


//INPUT DD DSNAME=FGLIB,DISP=(OLD,PASS) 
// DD DSNAME=GROUP2 ,DISP=SHR 


In this example, because the ddname is missing from the second DD statement, the system 
concatenates the data sets defined in these statements. 


//PAYROLL.DAY DD DSNAME=DESK,DISP=SHR 


In this example, if procedure step PAYROLL contains a DD statement named DAY, this 
statement overrides parameters on DD statement DAY. If the step does not contain DD 
statement DAY, the system adds this statement to procedure step PAYROLL for the duration 
of the job step. 


//STEPSIX.DD4 DD DSNAME=TEXT,DISP=(NEW,PASS) 
// DD DSNAME=ART,DISP=SHR 


In this example, the second data set 1s concatenated to the first, and both are added to 


procedure step STEPSIX. The ddname is omitted from the second DD statement in order to 
concatenate data set ART to data set TEXT. 
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DD: * Parameter 


* Parameter 


Defaults 


Parameter Type: Positional, optional 


Purpose: Use the * parameter to begin an in-stream data set. The data records immediately 
follow the DD * statement; the records must be in BCD or EBCDIC. The data records end 
when one of the following is found: 


/* in the input stream 

// to indicate another JCL statement 

The two-character delimiter specified by a DLM parameter on this DD statement 
The input stream runs out of card images 


Use a DATA parameter instead of the * parameter if any of the data records start with //. 


Syntax: 


//ddname DD *[,parameter]... [comments] 


When you do not code BLKSIZE and LRECL, JES uses installation defaults specified at 
initialization. 


Relationship to Other Parameters 


Restriction When Coding LRECL: If you code LRECL with the * parameter, code a record 
length of 80 or greater. 


Restrictions in a JES2 System: For JES2, the only DD parameters that you can code with the 
* parameter follow. All other parameters are a JCL error. 


DCB LRECL 
DLM REFDD 
DSID VOLUME 
LIKE 


Restrictions in a JES3 System: For JES3, the only DD parameters that you can code with the 
* parameter follow. All other parameters are a JCL error. 


DCB = BLKSIZE LIKE 


DCB=BUFNO LRECL 
DCB=LRECL REFDD 

DCB =MODE=C VOLUME =SER 
DLM 

DSID 


For JES3 SNA RJP Input: The only parameters you can specify for JES3 systems network 
architecture (SNA) remote job processing (RJP) input devices are BLKSIZE and LRECL. 
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DD: * Parameter 


For 3540 Diskette Input/Output Units; VOLUME=SER, BUFNO, and DSID on a DD * | 
statement are ignored except when they are detected by a diskette reader as a request for an 2 
associated data set. See IBM 3540 Programmer's Reference. On a DD * or DD DATA 

statement processed by a diskette reader, you can specify DSID and VOLUME=SER 

parameters to indicate that a diskette data set is to be merged into the input stream following 

the DD statement. 


Relationship to Other Control Statements 


Do not refer to an earlier DD * statement in DCB, DSNAME, or VOLUME parameters on 
following DD statements. 


Location in the JCL 
A DD * statement begins an in-stream data set. 


In-stream Data for Cataloged or In-stream Procedures: A cataloged or in-stream procedure J 
cannot contain a DD * statement. When you call a procedure, you can add input stream data 

to a procedure step by placing in the calling step one or more DD * or DD DATA statements, 

each followed by data. 


Multiple In-stream Data Sets for a Step: You can code more than one DD * or DD DATA 
statement in a job step in order to include several distinct groups of data for the processing 
program. Precede each group with a DD * or DD DATA statement and follow each group 
with a delimiter statement. If you omit a DD statement before and a delimiter after input data, 
the system provides a DD * statement with the ddname of SYSIN and ends the data when it Ss) 
reads a JCL statement or runs out of card images. 


Unread Records 


If the processing program does not read all the data in an in-stream data set, the system skips 
the remaining data without abnormally terminating the step. 


Examples of the * Parameter 


//INPUTL DD * 


//INPUT2 DD * 


/* 


This example defines two groups of data in the input stream. 
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DD: * Parameter 


//STEP2 EXEC PROC=FRESH 
/ /SETUP .WORK DD UNIT=3400-6, LABEL=(,NSL) 
//SETUP.INPUT1 DD * 


data 
. ‘ 
//PRINT.FRM DD UNIT=180 
//PRINT.INP DD * 


data 
/* 
This example defines two groups of data in the input stream. The input data defined by DD 
statement SETUP.INPUT]1 is to be used by the cataloged procedure step named SETUP. The 


input data defined by DD statement PRINT.INP is to be used by the cataloged procedure step 
named PRINT. 
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ACCODE Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the ACCODE parameter to specify or change an accessibility code for an 
ISO/ANSI/FIPS Version 3 tape output data set. An installation-written file-access exit routine 
verifies the code after the code is written to tape. If the code is authorized, the job step’s 
program can use the data set; if not, the system issues messages and may abnormally terminate 
the job step. 


A data set protected by an accessibility code should reside only on a volume protected by 


RACF or a volume accessibility code. The volume should not contain any unprotected data 
sets. 


Note: ACCODE is supported only for ISO/ANSI/FIPS Version 3 tape data sets. ACCODE is 
ignored for SL (IBM standard) label tapes. 


4 
References: For more information on ISO/ANSI/FIPS Version 3 tape data sets, see Magnetic J 
Tape Labels and File Structure Administration. 


Syntax: 


ACCODE=access-code 


Subparameter Definition J 


access-code 


Specifies an accessibility code. The access-code is | through 8 characters; the first 
character is an upper case letter from A through Z. 


Note: Only the first character is used as the ISO/ANSI/FIPS Version 3 accessibility code; 
the other seven characters can be used by the installation. If the first character is other 
than an upper case letter from A through Z, the installation does not give control to the 
file-access exit routine. 


Defaults 


If no accessibility code is specified on a DD statement that defines an ISO/ANSI/FIPS Version 
3 tape data set, the system writes a blank character (X’40’) in the tape label: a blank authorizes 
unlimited access to the tape’s data sets. 


If the installation does not supply a file-access exit routine, the system prevents access to any 
ISO/ANSI/FIPS Version 3 tape volume. 
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Overrides 


If PASSWORD or NOPWREAD is coded on the DD statement LABEL parameter, password 
access overrides the ACCODE parameter. 


Example of the ACCODE Parameter 
//TAPE DD UNIT=2400, VOLUME=SER=T49850,DSNAME=TAPEDS, 
// LABEL=(,AL) , ACCODE=Z 
In this example, the DD statement ACCODE parameter specifies an accessibility code of Z for 


tape volume T49850. The volume has ISO/ANSI/FIPS Version 3 labels. The data set 
TAPEDS is first on the tape. 
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AMP Parameter 


Parameter Type: Keyword, optional 


Note: With SMS, you can create new VSAM data sets with JCL DD statements. See the 
DATACLAS parameter (described on page 10-42) and the RECORG parameter (described on 
page 10-141). 


Purpose: Use the AMP parameter to complete information in an access method control block 
(ACB) for a VSAM data set. The ACB is a control block for entry-sequenced, key-sequenced, 
and relative record data sets. 


AMP is supported only for VSAM data sets. 


References: For more information on VSAM data sets, see VSAM Administration Guide, 
VSAM Administration: Macro Instruction Reference, and JCL User's Guide. 


Syntax: 


AMP=(subparameter ) 
AMP=('subparameter[,subparameter]...') 


The subparameters are: 


AMORG 
BUFND=number 
BUFNI=number 
BUFSP=number 
CROPS= (NCK 2 
NRC 
NRE 


RCK 
OPTCD=/I 


STRNO=number 
SYNAD=module 
TRACE=(subparameter[,subparameter]...) 


Parentheses: The subparameter or subparameters are always enclosed in one set of 
parentheses. For example, AMP=(AMORG). Note that AMP=’AMORG’ is also valid. 


Multiple Subparameters: When the parameter contains more than one subparameter, 
separate the subparameters by commas and enclose the subparameter list in apostrophes 
inside the parentheses. For example, AMP=(’AMORG,STRNO = 4’). 


Special Characters: When the parameter contains only one subparameter and that 
subparameter contains special characters, enclose the subparameter in apostrophes inside the 
parentheses. For example, AMP=(‘STRNO=4’). 


Note: Do not enclose a subparameter in a subparameter list in apostrophes. 


10-18 MVS/XA JCL Reference 


DD: AMP 


Continuation onto Another Statement: Enclose the subparameter list in only one set of 
parentheses. Enclose all the subparameters on each statement in apostrophes. End each 
statement with a comma after a complete subparameter. For example: 


//DS1 DD DSNAME=VSAMDATA, AMP=('BUFSP=200,OPTCD=IL,RECFM=FB', 
// 'STRNO=6') 


Subparameter Definition 


AMORG 
Indicates that the DD statement defines a VSAM data set. Code AMORG for either of 
the following reasons: 


e When data set access is through an ISAM interface program and the DD statement 
contains VOLUME and UNIT parameters or contains a DUMMY parameter. 


e To open an ACB for a VSAM data set, if the data set is not fully defined at the 
beginning of the job step. 


BUFND = number 
Specifies the number of I/O buffers that VSAM 1s to use for data records. The minimum 
is 1 plus the STRNO subparameter number. This value overrides the BUFND value 
specified in the ACB or GENCB macro, or provides a value if one is not specified. If you 
omit STRNO, BUFND must be at least 2. 


If you omit BUFND from AMP and from the ACB macro instruction, the system uses 
the STRNO number plus 1. 


BUFNI= number 
Specifies the number of I/O buffers that VSAM is to use for index records. This value 
overrides the BUFNI value specified in the ACB or GENCB macro, or provides a value if 
one is not specified. If you omit BUFNI from AMP and from the ACB macro 
instruction, VSAM uses as many index buffers as the STRNO subparameter number; if 
you omit both BUFNI and STRNO, VSAM uses | index buffer. 


If data access is through the ISAM interface program, specify for the BUFNI number 1 
more than the STRNO number, or specify 2 if you omit STRNO, to simulate having the 
highest level of an ISAM index resident. Specify a BUFNI number 2 or more greater 
than the STRNO number to simulate having intermediate levels of the index resident. 


BUFSP = number 
Specifies the maximum number of bytes for the data and index buffers in the user area. 
This value overrides the BUFSP value specified in the ACB or GENCB macro, or 
provides a value if one is not specified. 


If BUFSP specifies fewer bytes than the BUFFERSPACE parameter of the access method 
services DEFINE command, the BUFFERSPACE number overrides the BUFSP number. 
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CROPS = NCK 
CROPS = NRC 
CROPS = NRE 
CROPS = RCK 


Requests a checkpoint/restart option. For more information, see Checkpoint/ Restart 
User's Guide. 


NCK 
Requests no data set post-checkpoint modification tests. 


NRC 
Requests neither a data-erase test nor data set post-checkpoint modification tests. 


NRE 
Requests no data-erase test. 


RCK 
Requests a data-erase test and data set post-checkpoint modification tests. If the 
CROPS subparameter is omitted, RCK is the default. 


If you request an inappropriate option, such as the data-erase test for an input data set, 
the system ignores the option. 


OPTCD =I 
OPTCD=L 
OPTCD=IL 


Indicates how the ISAM interface program is to process records that the step’s processing 
program flags for deletion. 


I 
Requests, when the data control block (DCB) contains OPTCD=L, that the ISAM 
interface program is not to write into the data set records marked for deletion by 
the processing program. 
If AMP =(‘OPTCD =1’) ts specified without OPTCD = L in the DCB, the system 
ignores deletion flags on records. 

L 
Requests that the ISAM interface program is to keep in the data set records marked 
for deletion by the processing program. 
If records marked for deletion are to be kept but OPTCD=L is not in the DCB, 
AMP =(‘OPTCD =L’) ts required. 
Note: This parameter has the same meaning and restrictions for the ISAM 
interface as it has for ISAM. While it was not required in the ISAM job control 
language, you should code it in the AMP parameter. 

IL 


Requests that the ISAM interface program is not to write into the data set records 
marked for deletion by the processing program. If the processing program had read 
the record for update, the ISAM interface program deletes the record from the data 
set. 
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AMP=(‘OPTCD = IL’) has the same effect as AMP=(‘OPTCD =I’) coded with 
OPTCD =L in the DCB. 


RECFM =F 
RECFM =FB 
RECFM=V 
RECFM = VB 
(For data sets with SMS, see the DD RECFM parameter described on page 10-136.) 


Identifies the ISAM record format used by the processing program. You must code this 
RECFM subparameter when the record format is not specified in the DCB. 


Note: This parameter has the same meaning and restrictions for the ISAM interface as it 
has for ISAM. While it was not required in the ISAM job control language, you should 
code it in the AMP parameter. 


All VSAM requests are for unblocked records. If the processing program requests blocked 
records, the ISAM interface program sets the overflow-record indicator for each record to 
indicate that each is being passed to the program unblocked. 


F 
Indicates fixed-length records. 
FB 
Indicates blocked fixed-length records. 
V 
Indicates variable-length records. If no RECFM is specified in the AMP parameter 
or in the DCB, V is the default. 
VB 


Indicates blocked variable-length records. 


STRNO = number 
Indicates the number of request parameter lists the processing program uses concurrently. 
The number must at least equal the number of BISAM and QISAM requests that the 
program can issue concurrently. If the program creates subtasks, add together the 
number of requests for each subtask plus 1 for each subtask that sequentially processes 
the data set. This value overrides the STRNO value specified in the ACB or GENCB 
macro, or provides a value if one is not specified. 


SYNAD = module 
Names a SYNAD exit routine. The ISAM interface program is to load and exit to this 
routine if a physical or logical error occurs when the processing program 1s gaining access 
to the data set. 


The SYNAD parameter overrides a SYNAD exit routine specified in the EXLST or 
GENCB macro instruction that generates the exit list. The address of the intended exit 
list is specified in the access method control block that links this DD statement to the 
processing program. If no SYNAD exit is specified, the system ignores the AMP 
SYNAD parameter. 
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TRACE = (subparameter|,subparameter]...) 
Indicates that the generalized trace facility (GTF) executes with your job to gather 
information about the opening, closing, and end-of-volume processing for the data set 
defined on this DD statement. You can use the AMDPRDMP program to print the trace 
output; see SPL: Service Aids. 


The TRACE subparameters are: HOOK, ECODE, KEY, PARM1, and PARM2. See 
VSAM Administration Guide for full information on the TRACE subparameter and the 
VSAM trace facility, which you use to obtain diagnostic information during VSAM 
processing. 


Relationship to Other Parameters 


Do not code the following parameters with the AMP parameter. 


* 


BURST 
CHARS 
COPIES 
DATA 
DCB 


Invalid ddnames: 


JOBLIB 
STEPLIB 
SYSABEND 
SYSCHK 
SYSCKEOV 
SYSMDUMP 
SYSUDUMP 


DDNAME RECFM 
DYNAM SUBSYS 
FCB SYSOUT 
FLASH TERM 
MODIFY UCS 
QNAME 
The following ddnames are invalid for VSAM data sets: 


Invalid DSNAMEs: When you code the AMP parameter, the DSNAME must not contain 
parentheses, a minus (hyphen), or a plus (+) sign. The forms of DSNAME valid for ISAM, 
partitioned access method (PAM), and generation data groups (GDG) are invalid with VSAM 


data sets. 


Buffer Requirements 


For a key-sequenced data set, the total minimum buffer requirement is three: two data buffers 
and one index buffer. For an entry-sequenced data set, two data buffers are required. 


If the number of buffers specified in the BUFND and BUFNI subparameters causes the virtual 
storage requirements to exceed the BUFSP space, the number of buffers is reduced to fit in the 


BUFSP space. 


If BUFSP specifies more space than required by BUFND and BUFNI, the number of buffers is 
increased to fill the BUFSP space. 
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Examples of the AMP Parameter 


//VSAMDS1 DD DSNAME=DSM.CLASS ,DISP=SHR,AMP=('BUFSP=200,BUFND=2', 
if 'BUFNI=3 ,STRNO=4 , SYNAD=ERROR' ) 


In this example, the DD statement defines the size of the user area for data and index buffers, 
specifies the number of data and index buffers, specifies the number of requests that require 
concurrent data set positioning, and specifies an error exit routine named ERROR. 


//NSAMDS2 DD DSNAME=DSM.CLASS,DISP=SHR,AMP=('BUFSP=23456,BUFND=5', 
// "BUFNI=10, STRNO=6 , SYNAD=ERROR2 , CROPS=NCK', 
th ' TRACE= (PARM1=F00203000010, KEY=ABCDEF) ') 


In this example, the DD statement defines the values for BUFSP, BUFNI, STRNO, and 
SYNAD, as in the previous example. It also specifies that a data set post-checkpoint 
modification test is not to be performed when restarting at a checkpoint and that GTF is to 
provide a trace of specified data areas. 
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AVGREC Parameter 


Parameter Type: Keyword, optional — use this parameter only with SMS 
Purpose: Use the AVGREC parameter when you define a new data set to specify that: 
e The units of allocation requested for storage space are records. 


e The primary and secondary space quantity specified on the SPACE parameter represents 
units, thousands, or millions of records. 


When you use AVGREC with the SPACE parameter, the first subparameter (reclgth) on the 
SPACE parameter must specify the average record length of the records. 


Code the AVGREC parameter when you want to (1) specify records as the units of allocation 
or (2) override the space allocation defined in the data class for the data set. 


If SMS is not installed or is not active, the system syntax checks and then ignores the 
AVGREC parameter. 


Syntax: 


U 
AVGREC=}j K 


M 


Subparameter Definition 


U 
Specifies a record request and that the primary and secondary space quantity specified on 
the SPACE parameter represents the number of records in units (multiplier of 1). 
K 
Specifies a record request and that the primary and secondary space quantity specified on 
the SPACE parameter represents the number of records in thousands (multiplier of 1024). 
M 


Specifies a record request and that the primary and secondary space quantity specified on 
the SPACE parameter represents the number of records in millions (multiplier of 
1048576). 


Overrides 


AVGREC overrides the space allocation defined in the data class for the data set. 
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| Relationship to Other Parameters 


| Do not code AVGREC with the TRK, CYL, or ABSTR subparameters of the SPACE 
| parameter. 


| Do not code the following DD parameters with the AVGREC parameter. 


| * DYNAM 
DATA QNAME 
| DDNAME 


| Examples of the AVGREC Parameter 


| //SMSDS3 DD DSNAME=MYDS3.PGM,DATACLAS=DCLASO3,DISP=(NEW,KEEP), 
| J / SPACE=(128,(5,2)) ,AVGREC=K 


| In the example, the space allocation defined in the DCLAS03 data class is overridden by the 
| SPACE and AVGREC parameters, which indicate an average record length of 128 bytes, a 
| primary quantity of 5K (5,120) records, and a secondary quantity of 2K (2,048) records. 


| //SMSDS3A DD DSNAME=MYDS3.PGM,DATACLAS=DCLASO3A,DISP=(NEW,KEEP) , 
| Va AVGREC=K 


| In the example, the space allocation defined in the DCLASO3A data class is overridden by the 


| AVGREC parameter, which indicates that the primary and secondary quantity represents 
| thousands of records. 
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BURST Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the BURST parameter to specify that the output for this sysout data set printed 
on a 3800 Printing Subsystem is to go to: 


e The burster-trimmer-stacker, to be burst into separate sheets. 
e The continuous forms stacker, to be left in continuous fanfold. 


If the specified stacker is different from the last stacker used, or if a stacker was not previously 
requested, JES issues a message to the operator to thread the paper into the required stacker. 


Note: BURST applies only for an output data set printed on a 3800 equipped with a 
burster-trimmer-stacker. 


Syntax: 
BURST= (YES 
Y 
NO 
N 


Subparameter Definition 


Defaults 


Overrides 


YES 
Requests that the printed output is to be burst into separate sheets. This subparameter 
can also be coded as Y. 


NO 
Requests that the printed output is to be in a continuous fanfold. This subparameter can 
also be coded as N. 


If you do not code a BURST parameter, but you code a DD SYSOUT parameter and the 
sysout data set is printed on a 3800 that has a burster-trimmer-stacker, JES uses an installation 
default specified at initialization. 


If you do not code a BURST parameter or a DD SYSOUT parameter, the default is NO. 


A BURST parameter on a sysout DD statement overrides an OUTPUT JCL BURST 
parameter. 
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Relationship to Other Parameters 


Do not code the following parameters with the BURST parameter. 


. DSID PROTECT 
AMP DSNAME QNAME 
DATA DYNAM SUBSYS 
DDNAME ~~ LABEL VOLUME 
DISP MSVGP 


Relationship to Other Control Statements 
The burster-trimmer-stacker can also be requested using the following: 
e The BURST parameter on the OUTPUT JCL statement. 


@e The STACKER parameter on the JES3 //*FORMAT PR statement. 
e The BURST parameter on the JES2 /*OUTPUT statement. 


Example of the BURST Parameter 


//RECORD DD SYSOUT=A,BURST=Y 


In this example, the DD statement requests that JES send the output to the 
burster-trimmer-stacker of the 3800. The stacker separates the printed output into separate 
sheets instead of stacking it in a continuous fanfold. 
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CHARS Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the CHARS parameter to specify the name of one or more 
character-arrangement tables for printing this sysout data set on a 3800 Printing Subsystem. 


Note: CHARS applies only for an output data set that is printed on a 3800. 


References: For more information on character-arrangement tables, see the 3800 Printing 
Subsystem Programmer's Guide. Refer to Installation: System Generation for information on 
how to choose during system generation particular groups, other than the Basic group, which is 
always available. 


Syntax: 


table-name 
CHARS=|(table-name[,table-name]...) 

DUMP 

(DUMP[,table-name]...) 


e You can omit the parentheses if you code only one table-name or only DUMP. 


e Null positions in the CHARS parameter are invalid. For example, you cannot code 
CHARS = (,table-name) or CHARS = (table-name,,table-name). 


Subparameter Definition 


table-name 
Names a character-arrangement table. Each table-name is 1 through 4 alphanumeric or 
national ($, #, @) characters. Code from one to four names. 


DUMP 
Requests a high-density dump of 204-character print lines from a 3800. If more than one 
table-name is coded, DUMP must be first. 


Note: Use DUMP on a SYSABEND or SYSUDUMP DD statement. 
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Overrides 


DD: CHARS 


If you do not code the DD CHARS parameter, JES uses the following, in order: 


1. The CHARS parameter on an OUTPUT JCL statement, if referenced by the DD 
statement. 


2. The DD UCS parameter value, if coded. 
3. The UCS parameter on an OUTPUT JCL statement, if referenced. 


If no character-arrangement table is specified on the DD or OUTPUT JCL statements, JES 
uses an installation default specified at initialization. 


A CHARS parameters on a sysout DD statement overrides the OUTPUT JCL CHARS 
parameter. 


For a data set scheduled to the Print Services Facility (PSF), the PSF uses the following 
parameters, in override order, to select the font list: 


1. Font list in the library member specified by an OUTPUT JCL PAGEDEF parameter. 
2. DD CHARS parameter. 

3. OUTPUT JCL CHARS parameter. 

4. DD UCS parameter. 

5. OUTPUT JCL UCS parameter. 

6. JES installation default for the device. 

7. Font list on the PAGEDEF parameter in the PSF cataloged procedure. 


See “PAGEDEF Parameter” on page 17-51 for more information. 


Relationship to Other Parameters 


Do not code the following parameters with the CHARS parameter. 


- DSID PROTECT 
AMP DSNAME QNAME 
DATA DYNAM SUBSYS 
DDNAME~ LABEL VOLUME 
DISP MSVGP 
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Relationship to Other Control Statements 
CHARS can also be coded on the following: 
e The OUTPUT JCL statement. 


e The JES3 //*FORMAT PR statement. 
e The JES2 /*OUTPUT statement. 


Printing Device Reassignment 


The output device might not be a 3800, for example, if printing were reassigned to a 3211. See 
the 3800 Printing Subsystem Programmer's Guide for restrictions that apply. 


Requesting a High-Density Dump 
You can request a high-density dump on the 3800 through two parameters on the DD 
statement for the dump data set or on an OUTPUT JCL statement referenced by the dump DD 


statement: 


e FCB=STD3. This parameter produces dump output at 8 lines per inch. 
e CHARS=DUMP. This parameter produces 204-character print lines. 


You can code one or both of these parameters. You can place both on the same statement or 
one on each statement. 


Examples of the CHARS Parameter 


//DD1 DD SYSOUT=A,CHARS=(GS10,GU12) 


In this example, the CHARS parameter specifies two character-arrangement tables to be used 
when printing the data set: GS10 and GU12. 


//SYSABEND DD UNIT=3800,CHARS=DUMP, FCB=STD3 


The CHARS parameter on this SYSABEND DD statement specifies a high-density dump with 
204 characters per line. The FCB parameter requests the dump output at 8 lines per inch. 
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CHKPT Parameter 


Parameter Type: Keyword, optional 

Purpose: Use the CHKPT parameter to request that a checkpoint be written when each 
end-of-volume is reached on the multivolume data set defined by this DD statement. 
Checkpoints are written for all volumes except the last. Checkpoints can be requested for input 
or output data sets. 

Note: CHKPT is supported only for multivolume QSAM or BSAM data sets. CHKPT is 
ignored for single-volume QSAM or BSAM data sets or for ISAM, BDAM, BPAM, or VSAM 
data sets. 


References For more information, see Checkpoint/Restart User's Guide. 


Syntax: 


Cc CHKPT=EOV 


Subparameter Definition 


EOV 
Requests a checkpoint at each end-of-volume. 


Overrides 


e The RD parameter values of NC and RNC on the JOB or EXEC statements override the 
CHKPT parameter. 


e The CHKPT parameter overrides cataloged procedure values or START command values 
for checkpoints at end-of-volume. 


C Relationship to Other Parameters 


Do not code the following parameters with the CHKPT parameter. 


| * DYNAM 
| DATA QNAME 
| DDNAME  SYSOUT 


Relationship to the SYSCKEOV DD Statement 


If you specify CHKPT, you must also provide a SYSCKEOV DD statement in the job or step. 
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Checkpointing Concatenated Data Sets 


For concatenated BSAM or QSAM data sets, CHK PT must be coded on each DD statement in 
the concatenation, if checkpointing is desired for each data set in the concatenation. 


Examples of the CHKPT Parameter 


//DS1 DD DSNAME=INDS,DISP=OLD,CHKPT=EOV, 
L/ UNIT=SYSSQ , VOLUME=SER=(TAPEO1,TAPEO2 , TAPEO3) 


In this example, the DD statement defines data set INDS, a multivolume QSAM or BSAM 
data set for which a checkpoint is to be written twice: once when end-of-volume is reached on 
TAPE0O1 and once when end-of-volume is reached on TAPE02. 


//DS2 DD DSNAME=OUTDS ,DISP=(NEW,KEEP), 
// CHKPT=EOV, UNIT=SYSDA, VOLUME=(,,,8) } 


In this example, OUTDS is a multivolume data set that is being created. The data set requires 


eight volumes. Seven checkpoints will be written: when the end-of-volume is reached on 
volumes one through seven. 
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CNTL Parameter 


Parameter Type: Keyword, optional 
Purpose: Use the CNTL parameter to reference a CNTL statement that appears earlier in the 
job. The reference causes the subsystem to execute the program control statements within the 
referenced CNTL/ENDCNTL group. 


The system searches for an earlier CNTL statement with a label that matches the label in the 
CNTL parameter. If the system finds no match, the system issues an error message. 


Syntax: 


CNTL=|*.label 
*.,stepname. label 


*, stepname.procstepname.label 


Subparameter Definition 


* label 
Identifies an earlier CNTL statement, named label. The system searches for the CNTL 
statement first earlier in this step, then before the first EXEC statement of the job. 


* stepname.label 
Identifies an earlier CNTL statement, named label, that appears in an earlier step, 
stepname, in the same job. 


* stepname.procstepname.|label 
Identifies a CNTL statement, named label, in a cataloged or in-stream procedure. 


Stepname is the name of the job step that calls the procedure; procstepname is the name 
of the procedure step that contains the CNTL statement named label. 


Examples of the CNTL Parameter 


//MONDAY DD CNTL=*.WKLYPGM 
In this example, the DD statement requests that the system use the program control statements 


following the CNTL statement named WKLYPGM and located earlier in this step or preceding 
the first step. 


//TUESDAY DD CNTL=*.SECOND. BLOCKS 
In this example, the DD statement requests that the system use the program control statements 


following the CNTL statement named BLOCKS and located in a preceding step named 
SECOND. 
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/ /WEDNES DD CNTL=*.THIRD.PROCTWO.CANETTI J 


In this example, the DD statement requests that the system use the program control statements 
following the CNTL statement named CANETTI and located in the procedure step 
PROCTWO of the procedure called in the preceding job step THIRD. 


10-34 MVS/XA JCL Reference 


DD: COPIES 


COPIES Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the COPIES parameter to specify how many copies of this sysout data set are to 
be printed. The printed output is in page sequence for each copy. 


For printing on a 3800 Printing Subsystem, this parameter can instead specify how many copies 
of each page are to be printed before the next page is printed. 


Syntax: 


nnn 
COPIES=j (nnn, (group-value[,group-value]...)) 
(, (group-value[,group-value]...)) 


e You can omit the parentheses if you code only COPIES = nnn. 


e The following are not valid: 


— A null group-value, for example, COPIES = (5,(,)) or COPIES =(5,) 
— A zero group-value, for example, COPIES = (5,(1,0,4)) 
— A null within a list of group-values, for example, COPIES = (5,(1,,4)) 


Subparameter Definition 


non 
Specifies how many copies of the data set are to be printed; each copy will be in page 
sequence order. nnn is a number from 1 through 255 in a JES2 system and from 1 
through 254 in a JES3 system 


For a data set printed on a 3800, JES ignores nnn if any group-values are specified. 


group-value 
Specifies how many copies of each page are to be printed before the next page is printed. 
Each group-value is a number from 1 through 255 in a JES2 system and from 1 through 
254 in a JES3 system. You can code a maximum of eight group-values. Their sum must 
not exceed 255 or 254. The total copies of each page equals the sum of the group-values. 


Note: 


e This subparameter is valid only for 3800 output. 
@ For 3800 output, this subparameter overrides an nnn subparameter, if coded. 
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Defaults 


Overrides 


If you do not code a COPIES parameter on any of the following, code it incorrectly, or code 


COPIES =0, the system uses a default of 1, which is the default for the DD COPIES parameter. 


DD statement 
OUTPUT JCL statement 
For JES2, the /*OUTPUT statement 


A COPIES parameter on a sysout DD statement overrides an OUTPUT JCL COPIES 
parameter. 


If this DD statement references an OUTPUT JCL statement and that OUTPUT JCL statement 
contains a FORMDEF parameter, which specifies a library member, the COPYGROUP 
parameter on a FORMDEF statement in that member overrides any group-value 


subparameters on the OUTPUT JCL COPIES parameter or the sysout DD COPIES parameter. 


For more information, see “FORMDEF Parameter” on page 17-38. 


Relationship to Other Parameters 


Do not code the following parameters with the COPIES parameter. 


* DSNAME QNAME 
AMP DYNAM SUBSYS 
DATA LABEL VOLUME 
DDNAME  MSVGP 

DISP 


Relationship to FLASH Parameter: If this DD statement or a referenced OUTPUT JCL 
statement also contains a FLASH parameter, JES prints with the forms overlay the number of 
copies specified in one of the following: 


e COPIES=nnn, if the FLASH count is larger than nnn. For example, if COPIES=10 and 
FLASH =(LTHD,12) JES prints 10 copies, all with the forms overlay. 


@ The sum of the group-values specified in the COPIES parameter, if the FLASH count is 
larger than the sum. For example, if COPIES =(,(2,3,4)) and FLASH =(LTHD,12) JES 
prints nine copies in groups, all with the forms overlay. 


e The count subparameter in the FLASH parameter, if the FLASH count is smaller than nnn 
or the sum from the COPIES parameter. For example, if COPIES=10 and 
FLASH =(LTHD,7) JES prints seven copies with the forms overlay and three copies 
without. 
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Restriction When Coding UNIT Parameter: The COPIES parameter is normally coded with the 
SYSOUT parameter. If, however, both COPIES and UNIT appear on a DD statement, JES 
handles the COPIES parameter as follows: 


e nnn defaults to 1. 
e Only the first group-value is used, if group-values are specified and printing is on a 3800. 


Relationship to Other Control Statements 
The number of copies can also be specified on the COPIES parameter of the following: 


The OUTPUT JCL statement. 

The JES2 /*OUTPUT statement. 

The JES3 //*FORMAT PR statement. 
The JES3 //*FORMAT PU statement. 


For JES2, if you request copies of the entire job on the JES2 /*JOBPARM COPIES parameter 
and also copies of the data set on the DD COPIES or OUTPUT JCL COPIES parameter, and 
if this is a sysout data set, JES2 prints the number of copies equal to the product of the two 
requests. 


Using OUTPUT JCL COPIES by Nullifying DD Copies 


If both a DD statement and a referenced OUTPUT JCL statement contain COPIES 
parameters, the DD COPIES parameter normally overrides the OUTPUT JCL COPIES 
parameter. For example, four copies are printed of sysout data set DDA: 


//OTA OUTPUT COPIES=3 
//DDA DD SYSOUT=A, OUTPUT=* .OTA, COPIES=4 


However, if the DD COPIES is a null parameter, the OUTPUT JCL COPIES parameter is 
used. For example, three copies are printed of sysout data set DDB: 


//OTB OUTPUT COPIES=3 
//DDB DD SYSOUT=A , OUTPUT=* .OTB, COPIES= 


The following example shows a null COPIES parameter on an in-stream DD statement that 
overrides a procedure DD statement. The null COPIES parameter on DD statement PS.DDA 
nullifies the COPIES parameter on the procedure DD statement DDA, thereby allowing the 
COPIES parameter on OUTPUT JCL statement OT to be used. The system prints three copies 
of the DDA sysout data set. 


/ / TEX JOB ACCT34,'PAUL BENNETT! 

//INSTR PROC 

//PS EXEC  PGM=ABC 

//OT OUTPUT COPIES=3 

//DDA DD SYSOUT=A , OUTPUT=* .OT, COPIES=2 
// PEND 

//STEP1 EXEC PROC=INSTR 

//PS.DDA DD COPIES= 

Vas 


Note: If a null COPIES parameter appears on a DD statement that either does not reference an 
OUTPUT JCL statement or references an OUTPUT JCL statement that does not contain a 
COPIES parameter, the system uses a default of 1. 
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Examples of the COPIES Parameter 


//RECORD1 DD SYSOUT=A,COPIES=32 


This example requests 32 copies of the data set defined by DD statement RECORD1 when 
printing on an impact printer or a 3800. 


//RECORD2 DD SYSOUT=A,COPIES=(0,(1,2)) 


In this example, when printing on a 3800, three copies of the data set are printed in two groups. 
The first group contains one copy of each page. The second group contains two copies of each 
page. When printing on an impact printer, one copy (the default for nnn) is printed. 


//RECORD3 DD SYSOUT=A,COPIES=(8,(1,3,2)) 


In this example, when printing on a 3800, six copies of the data set are printed in three groups. 
The first group contains one copy of each page, the second group contains three copies of each 
page, and the last group contains two copies of each page. When the output device is not a 
3800, the system prints eight collated copies. : 


//RECORD4 DD UNIT=3800,COPIES=(1,(2,3)) 


Because the UNIT parameter is coded and the device is a 3800, the system prints only the first 
group-value: two copies of each page. 
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DATA Parameter 


Defaults 


Parameter Type: Positional, optional 


Purpose: Use the DATA parameter to begin an in-stream data set that contains statements 
with // in columns 1 and 2. The data records immediately follow the DD DATA statement; the 
records must be in BCD or EBCDIC. The data records end when one of the following is 
found: 


e /* in the input stream 
e The two-character delimiter specified by a DLM parameter on this DD statement 


e@ The input stream runs out of card images 


Note that, unlike a DD * statement, the data is not ended by the // that indicates another JCL 
statement. 


Syntax: 


//addname DD DATA[,parameter]... [comments] 


When you do not code BLKSIZE and LRECL, JES uses installation defaults specified at 
initialization. 


Relationship to Other Parameters 


Restrictions in a JES2 System: For JES2, the only DD parameters that you can code with the 
DATA parameter follow. All other parameters are a JCL error. 


DCB LRECL 
DLM REFDD 
DSID VOLUME 
LIKE 


Restrictions in a JES3 System: For JES3, the only DD parameters that you can code with the 
DATA parameter follow. All other parameters are a JCL error. 


DCB= BLKSIZE LIKE 
DCB=BUFNO LRECL 
DCB=LRECL REFDD 
DCB=MODE=C VOLUME=SER 
DLM 

DSID 


For JES3, when using the DCB= MODE=C subparameter with the DATA parameter, 
DCB=MODE=C must be the only parameter specified with the DATA parameter. 
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For 3540 Diskette Input|Output Units: VOLUME=SER, BUFNO, and DSID on a DD 

DATA statement are ignored except when they are detected by a diskette reader as a request S) 
for an associated data set. See JBM 3540 Programmer's Reference. On a DD * or DD DATA 

statement processed by a diskette reader, you can specify DSID and VOLUME=SER 

parameters to indicate that a diskette data set is to be merged into the input stream following 

the DD statement. 


Relationship to Other Control Statements 


Do not refer to an earlier DD DATA statement in DCB, DSNAME, or VOLUME parameters 
on following DD statements. 


Location in the JCL 


A DD DATA statement begins an in-stream data set. 


In-stream Data for Cataloged or In-stream Procedures: A cataloged or in-stream procedure 
cannot contain a DD DATA statement. When you call a procedure, you can add input stream 
data to a procedure step by placing in the calling step one or more DD * or DD DATA 
statements, each followed by data. 


Multiple In-stream Data Sets for a Step: You can code more than one DD * or DD DATA 

statement in a job step in order to include several distinct groups of data for the processing 

program. Precede each group with a DD * or DD DATA statement and follow each group 

with a delimiter statement. If you omit a DD statement before and a delimiter after input data, 

the system provides a DD * statement with the ddname of SYSIN and ends the data when it JY 
reads a JCL statement or runs out of card images. 


Unread Records 


If the processing program does not read all the data in an in-stream data set, the system skips 
the remaining data without abnormally terminating the step. 


Examples of the DATA Parameter J 


//GROUP1 DD DATA 


data 
. 3 
/ /GROUP2 DD DATA 


data 
/* 


This example defines two groups of data in the input stream. 
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//STEP2 
/ /PREP .DD4 


47, 
//PREP.IN1 


x 
//ADD.IN2 


y* 


DD: DATA 


EXEC PROC=UPDATE 

DD DSNAME=A.B.C,UNIT=3350, VOLUME=SER=D88230, 
SPACE=(TRK, (10,5) ) ,DISP=(,CATLG, DELETE) 

DD DATA 


data 
DD * 


data 


This example defines two groups of data in the input stream. The input defined by DD 
statement PREP.IN1 is to be used by the cataloged procedure step named PREP. This data 
contains job control statements. The input data defined by DD statement ADD.IN2 is to be 
used by the cataloged procedure step named ADD. Because this data is defined by a DD * 
statement, it must not contain job control statements. 
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DD: DATACLAS 


DATACLAS Parameter 


Parameter Type: Keyword, optional — use this parameter only with SMS 


Without SMS, use the DCB parameter (described on page 10-44) or the AMP parameter 
(described on page 10-18). 


Purpose: Use the DATACLAS parameter to specify a data class for a new data set. The 
storage administrator at your installation defines the names of the data classes you can code on 
the DATACLAS parameter. 


If SMS is not installed or is not active, the system syntax checks and then ignores the 
DATACLAS parameter. 


SMS ignores the DATACLAS parameter if you specify it for (1) an existing data set or (2) a 
data set that SMS does not support (such as a tape data set). 


You can use the DATACLAS parameter for both VSAM data sets and physical sequential (PS) 
or partitioned (PO) data sets. 


A data class defines the following data set allocation attributes: 


e Data set organization 

— Record organization (RECORG) or 

— Record format (RECFM) 

Record length (LRECL) | 
Key length (KEYLEN) - 
Key offset (KEYOFF) 

Space allocation (AVGREC and SPACE) 

Retention period (RETPD) or expiration date (EXPDT) 

Volume-count (VOLUME) 

For VSAM data sets IMBED or REPLICATE, CISIZE, FREESPACE, 

SHAREOPTIONS) 


References: See MVS/XA Interactive Storage Management Facility User’s Guide for 
information on how to use ISMF to view your installation-defined data classes. ) 


Syntax: 


DATACLAS=data-class~name 


Subparameter Definition 


data-class-name 
Specifies the name of a data class to be used for allocating the data set. 


The name, one to eight characters, is defined by the storage administrator at your 
installation. 
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Defaults 


Overrides 


DD: DATACLAS 


If you do not specify DATACLAS for a new data set and the storage administrator has 
provided an installation-written automatic class selection (ACS) routine, the ACS routine may 
select a data class for the data set. Check with your storage administrator to determine if an 
ACS routine will select a data class for the new data set, in which case you do not need to 
specify DATACLAS. 


Any attributes you specify on the same DD statement using the following parameters, override 
the corresponding attributes in the named data class for the data set: 


RECORG (record organization) or RECFM (record format) 

LRECL (record length) 

KEYLEN (key length) 

KEYOFF (key offset) 

AVGREC (record request and space quantity) 

SPACE (average record length, primary, secondary, and directory quantity) 
RETPD (retention period) or EXPDT (expiration date) 

VOLUME (volume-count) 


An ACS routine can override the data class that you specify on the DATACLAS parameter. 


Relationship to Other Parameters 


Do not code the following DD parameters with the DATACLAS parameter. 


- DYNAM 
DATA QNAME 
DDNAME 


Examples of the DATACLAS Parameter 


//SMSDS1 DD DSNAME=MYDS1.PGM,DATACLAS=DCLASO1,DISP=(NEW,KEEP) 


In the example, the attributes in the data class named DCLASO1 are used by SMS to handle 
the data set. Note that installation-wntten ACS routines may select a management class and 
storage class and can override the specified data class, 


//SMSDS2. DD DSNAME=MYDS2.PGM,DATACLAS=DCLASO2 ,DISP=(NEW,KEEP), 
// LRECL=256 , EXPDT=1996/033 


In the example, the logical record length of 256 and the expiration date of February 2, 1996, 
override the corresponding attributes defined in the data class for the data set. Note that 
installation-written ACS routines may select a management class and storage class and can 
override the specified data class. 
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DD: DCB 


DCB Parameter 


Parameter Type: Keyword, optional 


Note: With SMS, you do not need to use the DCB parameter to specify data set attributes. 
See the DATACLAS parameter (described on page 10-42), the LIKE parameter (described on 
page 10-115), and the REFDD parameter (described on page 10-143). 


Purpose: Use the DCB parameter to complete during execution the information in the data 
control block (DCB) for a data set. 


The data control block is constructed by the DCB macro instruction in assembler language 
programs or by file definition statements or language-defined defaults in programs in other 
languages. 


References: For more information on constructing the data control block, see Data 
Administration Guide. 


Syntax: 


DCB=(subparameter[,subparameter]...) 


dsname 

* ,ddname 

*,stepname.ddname [,subparameter]... 
*, stepname.procstepname.ddname 


Parentheses: You can omit the parentheses if you code: 
Only one keyword subparameter. 
Only a data set name, dsname, without any subparameters. 


Only a backward reference without any subparameters. A backward reference is a reference to an 


earlier DD statement in the job or in a cataloged or in-stream procedure called by a job step. A 
backward reference is in the form *.ddname or *.stepname.ddname or 
* stepname.procstepname.ddname. 


For example, DCB = RECFM = FB or DCB=WKDATA or DCB=*.STEP3.DD2 


Multiple Subparameters: When the parameter contains more than one subparameter, separate the 
subparameters by commas and enclose the subparameter list in parentheses. For example, 
DCB=(RECFM = FB,LRECL = 133, BLKSIZE = 399) or DCB=(*.DD1,BUFNO=4) 


Continuation onto Another Statement: Enclose the subparameter list in only one set of parentheses. End 
each statement with a comma after a complete subparameter. For example: 


//INPUT DD DSNAME=WKDATA, DCB=(RECFM=FB,LRECL=80,BLKSIZE=800, 
Jy BUFL=800, BUFNO=4) 
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DD: DCB 


Alternate Syntax for DCB Keyword Subparameters: 


All of the DCB keyword subparameters can be specified without the need to code DCB=. For example, 
the following DD statement: 


//DDEX DD DSNAME=WKDATA, DCB=(RECFM=FB ,LRECL=80,BLKSIZE=800) ,DISP=MOD 


can also be specified as: 


//DDEX DD DSNAME=WKDATA, RECFM=FB ,LRECL=80 ,BLKSIZE=800 ,DISP=MOD 


Note that KEYLEN, LRECL, and RECFM are described as DD parameters. 


Subparameter Definition 


subparameter 
(With SMS, see the DD DATACLAS parameter.) 


Specifies a DCB keyword subparameter needed to complete the data control block. 


An alphabetic summary of the DCB keyword subparameters follows this parameter 
description. 


You must supply DCB information through the DCB subparameters if your processing 
program, the data set label, or your language’s defined values do not complete the data 
control block. 


dsname 
(With SMS, see the DD LIKE parameter.) 


Names a cataloged data set. The system is to copy DCB information from the data set’s 
label. The data set must reside on a direct access volume, and the volume must be 
mounted before the job step is executed. 


A hyphen is a valid character in a catalogued data set name. A data set name that 
contains a hyphen must be enclosed in apostrophes if it is used as a DCB subparameter. 


The dsname cannot contain any other special characters, except for periods used in 
qualifying the name. Do not specify a generation data group (GDG) name. 


The system copies the following DCB information from the data set label: 


DSORG (used in a backward reference) 
RECFM 

OPTCD 

BLKSIZE 

LRECL 

KEYLEN 

RKP 


If you do not specify the system code and expiration date of the cataloged data set, the 
system copies them from the data set label. 
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DD: DCB 


If you code any DCB subparameters after the dsname, these subparameters override the 
corresponding subparameters in the data set label. The system copies from the referenced 
label only those subparameters not specified on the referencing DD statement. 


* ddname 
* stepname.ddname 
* stepname. procstepname.ddname 
(With SMS, see the DD REFDD parameter.) 


Specify a backward reference to an earlier DD statement. The system is to copy DCB 
information from the DCB parameter specified on that DD statement. The DCB 
parameter of the referenced DD statement must contain subparameters, and it cannot 
name a cataloged data set or refer to another DD statement. 


* ddname specifies the ddname of an earlier DD statement in the same step. 

* stepname.ddname specifies the ddname of a DD statement in an earlier step, stepname, 
in the same job. *.stepname.procstepname.ddname specifies the ddname of a DD 
statement in a cataloged or in-stream procedure called by an earlier job step. Stepname is 
the name of the job step that calls the procedure and procstepname is the name of the 
procedure step that contains the DD statement. 


If you code any DCB subparameters after the reference, these subparameters override the 
corresponding subparameters on the referenced DD statement. The system copies from 
the referenced DD statement only those subparameters not specified on the referencing 
DD statement. 


Do not reference a DD * or a DD DATA statement. 


Note: The system also copies the UCS and FCB parameters from the referenced DD 
statement, unless you override them in the referencing DD statement. 


Completing the Data Control Block 


The system obtains data control block information from the following sources, in override 
order: 


e The processing program, that is, the DCB macro instruction in assembler language 
programs or file definition statements or language-defined defaults in programs in other 
languages. 


@ The DCB subparameter of the DD statement. 

e The data set label. 

Therefore, if you supply information for the same DCB field in your processing program and 
on a DD statement, the system ignores the DD DCB subparameter. If a DD statement and the 
data set label supply information for the same DCB field, the system ignores the data set label 
information. 

Note: When concatenated data sets are involved, the DCB is completed based on the type of 


data set and how the processing program uses the data set. See MVS/XA Data Administration 
Guide for more information. 
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Relationship to Other Parameters 


See the descriptions of the individual DCB subparameters for the DD parameters and DCB 
subparameters that should not be coded with a specific DCB subparameter. 


Do not code the following parameters with the DCB parameter. 


AMP 
DYNAM 


With the DDNAME parameter, code only the BLKSIZE, BUFNO, and DIAGNS DCB 
subparameters. 


With the QNAME parameter, code only the BLKSIZE, LRECL, OPTCD, and RECFM DCB 
subparameters. 


The DD parameter KEYLEN and DCB subparameters KEYLEN, MODE, PRTSP, STACK, 
and TRTCH apply to specific device types. If you specify one of these subparameters on a DD 
statement for a device different from the type to which it applies, the system interprets the value 
incorrectly. 


For 3540 Diskette Input{Output Units: The VOLUME=SER, DCB=BUFNO, and DSID 


parameters on a DD * or DD DATA statement are ignored except when they are detected by a 
diskette reader as a request for an associated data set. See JBM 3540 Programmer's Reference. 


Examples of the DCB Parameter 


//DD1 DD DSNAME=ALP , DISP=(,KEEP) , VOLUME=SER=44321, 
// UNIT=3400-6 , DCB= (RECFM=FB,LRECL=240 ,BLKSIZE=960, 
// DEN=1,TRTCH=C) 


DD statement DD1 defines a new data set named ALP. The DCB parameter contains the 
information necessary to complete the data control block. 


//DD1A DD DSNAME=EVER,DISP=(NEW,KEEP) ,UNIT=3380, 
// DCB= (RECFM=FB,LRECL=326 , BLKSIZE=23472) , 
// SPACE= (23472, (200,40) ) 


DD statement DD1A defines a new data set named EVER on a 3380. The DCB parameter 
contains the information necessary to complete the data control block. 


//DD1B DD DSNAME=EVER , DISP=(NEW, KEEP) , UNIT=3380, 
If RECFM=FB, LRECL=326, 
// SPACE= (23472, (200,40) ) 


DD statement DD1B is the same as the DDIA statement except that it shows the alternate 
syntax for the DCB keyword subparameters. Also, because BLKSIZE is omitted, the system 
will select an optimum block size for the data. 
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//DD2 DD DSNAME=BAL , DISP=OLD , DCB=(RECFM=F ,LRECL=80, 

J / BLKSIZE=80) 

//DD3  ~+DD DSNAME=CNANN , DISP=(,CATLG, DELETE) , UNIT=3400-6, 
TJ LABEL=(,NL) , VOLUME=SER=66 3488 , DCB=* .DD2 


DD statement DD3 defines a new data set named CNANN and requests that the system copy 
the DCB subparameters from DD statement DD2, which is in the same job step. 


//DD4 DD DSNAME=JST,DISP=(NEW, KEEP) , UNIT=3350, 
J/ SPACE=(CYL, (12,2) ) ,DCB=(A.B.C,KEYLEN=8) 


DD statement DD4 defines a new data set named JST and requests that the system copy the 
DCB information from the data set label of the cataloged data set named A.B.C. If the data 
set label contains a key length specification, it is overridden by the KEYLEN coded on this DD 


statement. 
//DD5 DD DSNAME=SMAE , DISP=OLD, 
Pa DCB=(*.STEP1.PROCSTPS5.DD8,BUFNO=5) 


DD statement DDS defines an existing, cataloged data set named SMAE and requests that the 
system copy DCB subparameters from DD statement DD8, which is contained in the procedure 
step named PROCSTPS. The cataloged procedure is called by EXEC statement STEP1. Any 
of the DCB subparameters coded on DD statement DD8 are ignored if they are specified in the 
program. If the DCB BUFNO subparameter is not specified in the program, five buffers are 
assigned. 
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DCB Subparameters 


Access Method 


DCB 
Subparameters 


Description of Subparameters 
BFALN BFALN = {F|D} 


Specifies that each buffer starts either on a word boundary that is not also a 
doubleword boundary or on a doubleword boundary. If both BFALN and 
BFTEK are specified, they must be specified from the same source. 


Default: D (doubleword) 


| Note: Do not code the BFALN subparameter with DCB subparameter GNCP, or 
| DD parameters DDNAME, QNAME. 


BFTEK BFTEK=R for BDAM and BSAM 
BFTEK =D for BTAM 
BFTEK =({S|E|A} for QSAM 


R Specifies that the data set is being created for or contains variable-length 
spanned records. 

D Specifies that dynamic buffering is to be used in the processing program; if 
dynamic buffering is specified, a buffer pool must also be defined. 

S, E, and A 
Specify simple, exchange, or locate mode logical record interface for 
spanned records. S, E, or A can be coded only when RECFM=VS. 


If both BFALN and BFTEK are specified, they must be specified from the same 
source. 


| Note: Do not code the BFTEK subparameter with DCB subparameter GNCP, or 
| DD parameters DDNAME, QNAME. 


BLKSIZE BLKSIZE = bytes 


Specifies the maximum length, in bytes, of a block. The maximum is 32760. The 
number you specify for BLKSIZE depends on the device type and the record 
format for the data set. For ASCII data sets on magnetic tape, the minimum 
value for BLKSIZE is 18 bytes and the maximum is 2048 bytes. If you code the 
BLKSIZE subparameter in the DCB macro instruction or on a DD statement 
that defines an existing data set with standard labels, the DCB BLKSIZE 
overrides the block size specified in the label. BLKSIZE can be coded but will 
have no effect on EXCP processing. 


| Default: If you do not code BLKSIZE, the system determines an optimum block 
| size for the data. 
| 
| 


Note: Do not code the BLKSIZE subparameter with DCB subparameter 
BUFSIZE. 


BUFIN BUFIN = buffers 


Specifies the number of buffers to be assigned initially for receiving operations for 
each line in the line group. The combined BUFIN and BUFOUT values must 
not be greater than the number of buffers in the buffer pool for this line group 
(not including those for disk activity only). 


Default: 1 


| Note: Do not code the BUFIN subparameter with DCB subparameter BUFNO, 
| or DD parameters DDNAME, QNAME. 


BUFL BUFL= bytes 


Specifies the length, in bytes, of each buffer in the buffer pool. The maximum is 
32760. 


Note: Do not code the BUFL subparameter with DD parameter DDNAME. 
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Access Method 


DCB 
Subparameters 


BUFMAX 


BUFNO 


BUFOFF 


BUFOUT 


BUFSIZE 


CPRI 


CYLOFL 
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Description of Subparameters 
BUFMAX = buffers 


Specifies the maximum number of buffers to be allocated to a line at one time. 
Number must be 2 through 15 and must be equal to or greater than the larger of 
the numbers specified by the BUFIN and BUFOUT subparameters. 


Default: 2 


Note: Do not code the BUFMAX subparameter with DCB subparameter NCP, 
or DD parameters DDNAME, QNAME. 


BUFNO = buffers 


Specifies the number of buffers to be assigned to the DCB. The maximum 
normally is 255, but can be less because of the size of the region. 


Note: Do not code the BUFNO subparameter with DCB subparameters BUFIN, 
BUFOUT, or DD parameter QNAME. 


BUFOFF = {n|L} 


n Specifies the length, in bytes, of the block prefix used with an ASCII tape 
data set. For input, n can be 0 through 99. For output, n must be 0 for 
writing an output data set with fixed-length or undefined-length records. 


Specifies that the block prefix is 4 bytes and contains the block length. 
BUFOFF = L is valid only with RECFM=D. For output, only 
BUFOFF = L is valid. 


Note: Do not code the BUFOFF subparameter with DD parameters DDNAME, 
QNAME. 


BUFOUT = buffers 


Specifies the number of buffers to be assigned initially for sending operations for 
each line in the line group. The combined number of BUFIN and BUFOUT 
values must not be greater than the number of buffers in the buffer pool for this 
line group (not including those for disk activity only) and cannot exceed 15. 


Default: 2 


Note: Do not code the BUFOUT subparameter with DCB subparameter 
BUFNO, or DD parameter DDNAME. 


BUFSIZE = bytes 


Specifies the length, in bytes, of each of the buffers to be used for all lines in a 
particular line group. Length must be 31 through 65535 bytes. 


Note: Do not code the BUFSIZE subparameter with DCB subparameter 
BLKSIZE, or DD parameters DDNAME, QNAME. 


CPRI = {R|E|S} 


Specifies the relative transmission priority assigned to the lines in this line group. 
R Specifies that processor receiving has priority over processor sending. 

E Specifies that receiving and sending have equal priority. 

S Specifies that processor sending has priority over processor receiving. 


Note: Do not code the CPRI subparameter with DCB subparameter THRESH, 
or DD parameters DDNAME, OUTLIM, QNAME. 


CYLOFL = tracks 


Specifies the number of tracks on each cylinder to hold the records that overflow 
from other tracks on that cylinder. The maximum is 99. Specify CYLOFL only 
when OPTCD=Y. 


Note: Do not code the CYLOFL subparameter with DCB subparameter 
RESERVE, or DD parameters DDNAME, FCB, QNAME, UCS. 


Access Method 


B 
B/I|B/B|B|E 
D|S|P|S|T/X 
DCB A|A|A/A|/A/C 
Subparameters M|M|M M M|P|M|M|M|M 


7 TPA 


DSORG X}X|] XX] X| XX) XX) X| X] xX 
| 
| 


DD: DCB 


Description of Subparameters 
DEN = {1/2/34} 


Specifies the magnetic density, in number of bytes-per-inch, used to write a 
magnetic tape data set. 


800 (NRZI) 


1600 (PE) 
6250 (GCR) 


NRZI Non-return-to-zero inverted recording mode. 
PE Phase encoded recording mode. 
GCR_ Group coded recording mode. 


Default: 800 bpi assumed for 7-track tape and 9-track without dual density. 
1600 bpi assumed for 9-track with dual density or phase-encoded 
drives. 
6250 bpi assumed for 9-track with 6250/1600 bpi dual density or group 
coded recording tape. 


Note: Do not code the DEN subparameter with DD parameters DDNAME, 
QNAME. 


DIAGNS = TRACE 


Specifies the OPEN/CLOSE/EOV trace option, which gives a module-by-module 
trace of OPEN/CLOSE/EOV’s work area and the DCB. If the generalized trace 
facility (GTF) is not running and tracing user events, DIAGNS is ignored. 


DSORG = organization 


Specifies the organization of the data set and indicates whether the data set 
contains any location-dependent information that would make the data set 
unmovable. 


Note: Do not code the DSORG subparameter with DD parameters DDNAME, 
QNAME, RECORG. 


PS Physical sequential data set BSAM,EXCP,QSAM,TCAM 


PSU __— Physical sequential data set that con- BSAM,QSAM,EXCP 
tains location-dependent information 

DA Direct access data set BDAM,EXCP 

DAU Direct access data set that contains BDAM,EXCP 
location-dependent information 

IS Indexed sequential data set BISAM,QISAM,EXCP 

ISU Indexed sequential data set that con- QISAM,EXCP 
tains location-dependent information 

PO Partitioned data set BPAM,EXCP 

POU Partitioned data set that contains BPAM,EXCP 
location-dependent information 

CX Communications line group BTAM 

GS Graphic data control block 
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Access Method 


B Q 

B;/I)B;/B|;BIE 1/;Q|T 

D|S|P|S|T/X|/G/S;}S/C 
DCB A|AJA/A/A|C;A/;A;A/A 
Subparameters M|M|M|M|M/ P|M|M|M|M 


i 


| i 


- THI 
- Vi 


- AT 
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Description of Subparameters 
EROPT =x 


BTAM: _ Requests the BTAM on-line terminal test option. 
x=T 
Specifies the option to be executed if an error occurs in reading 
or writing a record. 
x=ACC System is to accept the block causing the error. 
SKP System is to skip the block causing the error. 
ABE System is to cause abnormal end of task. 


Default: ABE 


QSAM: 


Note: Do not code the EROPT subparameter with DD parameters DDNAME, 
QNAME. 


FUNC ={I|R|P|W|D[X/T} 


Specifies the type of data set to be opened for a 3505 Card Reader or 3525 Card 
Punch. Unpredictable results will occur if coded for other than a 3505 or 3525. 


Data set is for punching and printing cards. 
Data set is for reading cards. 

Data set is for punching cards. 

Data set is for printing. 

Protected data set is for punching. 

Data set is for both punching and printing. 
Two-line print option. 


The only valid combinations of these values are: 
WT RWT RPWXT 
RP PW RPWD 
RPD PWXT RWX 
RW RPW RWXT 


Default: P, for output data set. R, for input data set. 


Note: Do not code the FUNC subparameter with the data-set-sequence number 
of the DD LABEL parameter, or DD parameters DDNAME, QNAME. 


GNCP=n 


Specifies the maximum number of I/O macro instructions that the program will 
issue before a WAIT macro instruction. 


Note: Do not code the GNCP subparameter with DCB subparameters BFALN, 
BFTEK, or DD parameters DDNAME, QNAME. 


INTVL= {n|0} 
Specifies the interval, in seconds, between passes through an invitation list. 
Default: 0 


Note: Do not code the INTVL subparameter with DD parameters DDNAME, 
FCB, QNAME, UCS. 


IPLTXID = member 


Specifies the name of the partitioned data set member that you want loaded into a 
3704/3705 Communications Controller. The DCB IPLTXID subparameter 
overrides IPLTXID in the TERMINAL macro representing the NCP. 


Note: Do not code the IPLTXID subparameter with DD parameters DDNAME, 
DSNAME, QNAME. 


DD: DCB 


} Access Method = } Access Method = 


G 
DCB a 
Subparameters Description of Subparameters 


KEYLEN X| X X] KEYLEN = bytes 
Information for the DCB KEYLEN keyword subparameter is moved to the DD 
KEYLEN parameter described on page 10-104. 


LIMCT LIMCT = {blocks|tracks} 
Specifies how many blocks (if relative block addressing is used) or how many 
tracks (if relative track addressing is used) are to be searched for a free block or 
available space. This kind of search occurs only when DCB OPTCD = E is also 
specified; otherwise, LIMCT is ignored. If the LIMCT number equals or exceeds 
the number of blocks or tracks in the data set, the entire data set is searched. 
Note: Do not code the LIMCT subparameter with DD parameters DDNAME, 
QNAME. 


LRECL X| X xX X |X| Xj] LRECL =bytes 
Information for the DCB LRECL keyword subparameter is moved to the DD 
LRECL parameter described on page 10-117. 


MODE », 4 Xx »,« 
MODE= 
Specifies the mode of operation to be used with a card reader, a card punch, or a 
card read-punch. 
C Card image (column binary) mode 
E EBCDIC mode 
O Optional mark read mode 
R_ Read column eliminate mode 
If you specify R, you must also specify either C or E. Do not code the MODE 
subparameter for data entered through the input stream except in a JES3 system. 
Do not code MODE =C for JES2 or JES3 output. 
Default: E 
Note: Do not code the MODE subparameter with DCB subparameters 
KEYLEN, PRTSP, TRTCH, or DD parameters DDNAME, KEYLEN, 
QNAME. 

NCP X|X} X NCP=n 
Specifies the maximum number of READ or WRITE macro instructions that will 
be issued before a CHECK macro instruction is issued to test for completion of 
the 1/O operation. The maximum number is 99, but may actually be smaller 
depending on the size of the region or partition. If chained scheduling is used, 
the number must be greater than 1. 
Default: 1 
Note: Do not code the NCP subparameter with DCB subparameter BUFMAX, 
or DD parameters DDNAME, QNAME. 
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zeae 
a 
zeae 
Em 
a 
PExmy 
Eerie 
“[zeas 


a 
~ 


DD: DCB 


Access Method 


DCB 
Subparameters 


NTM 


OPTCD 
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Description of Subparameters 


NTM = tracks 


Specifies the number of tracks to be used for a cylinder index. When the specified 
number of tracks has been filled, a master index is created. The DCB NTM is 
needed only when the DCB OPTCB=M. If you specify OPTCD=M but omit 
NTM, the master index option is ignored. 


Note: Do not code the NTM subparameter with DCB subparameter PCI, or DD 
parameters DDNAME, QNAME. 


Specifies the optional services to be performed by the control program. All 
optional services must be requested in one source, that is, in the data set label of 
an existing data set, in the DCB macro, or in the DD DCB parameter. However, 
the processing program can modify the DCB OPTCD field. Code the characters 
in any order; when coding more than one, do not code commas between the 
characters. 


Note: Do not code the OPTCD subparameter with DD parameter DDNAME. 


indicates that the actual device addresses are to be specified in READ and 
WRITE macro instructions. 


indicates that relative block addresses are to be specified in READ and 
WRITE macro instructions. 


indicates that an extended search (more than one track) is to be performed 
for a block of available space. LIMCT must also be coded. Do not code 
LIMCT = 0 because it will cause an abnormal termination when a READ or 
WRITE macro instruction is executed. 

indicates that feedback can be requested in READ and WRITE macro 
instructions and the device is to be identified in the same form as it was 
presented to the control program. 


requests a validity check for write operations on direct access devices and 
the IBM 3480 Magnetic Tape Subsystem. 


BISAM: OPTCD = {[L][R][W]} 


L requests that the control program delete records that have a first byte of all 
ones. These records will be deleted when space is required for new records. 
To use the delete option, the DCB RKP must be greater than zero for 
fixed-length records and greater than four for variable-length records. 


requests that the control program place reorganization criteria information 
in certain fields of the DCB. The problem program can analyze these 
statistics to determine when to reorganize the data set. 


W _ requests a validity check for write operations on direct access devices. 
Default: R, whenever the OPTCD subparameter is omitted from all sources. 


BPAM: OPTCD= /(C(WiICW 
C|H|HC 
C|WH|WHC 


requests chained scheduling. 


C 

W _ requests a validity check for write operations on direct access devices. 

H _ requests that a partitioned data set being processed and residing on MSS, if 
opening for input, is to be staged to end of file (EOF) on the virtual 
DASD. Otherwise, only the directory is staged. 


DD: DCB 


Access Method 


DCB 
Subparameters 


Ec 
Ferrer 
Ec 
zeae 
Ec 
ECC 
zea! 
Eecer) 
zeae | 
Zeer | 


Description of Subparameters 


OPTCD BSAM and QSAM: OPTCD= /{B 
(continued) T 
UIC] 
C[T][BI[U] 
H[Z][B] 
JU] 
W(CI[TI[BI[U] 
Z(CTI[BI[U] 
Q(C)[TI[B] 
Z 
requests that the end-of-volume (EOV) routine disregard the end-of-file 
(EOF) recognition for magnetic tape. For an input data set ona 
standard-labeled (SL or AL) tape, the EOV routine treats EOF labels as 
EOV labels until the volume serial list is exhausted. This option allows SL 
or AL tapes to be read out of volume sequence or to be concatenated to 
another tape with the same data set name using one DD statement. 
requests chained scheduling. 
requests hopper empty exit for optical readers or bypass of DOS checkpoint 
records. 
for a data set to be printed on a 3800 Printing Subsystem, instructs the 
system that the logical record for each output data line contains a table 
reference character (TRC). The TRC identifies which character 
arrangement table in the CHARS parameter is to be used to print the line. 
Before specifying OPTCD = J, see the 3800 Printing Subsystem 
Programmer's Guide. 
requests (1) that ASCII tape records in an input data set be converted to 
EBCDIC code when the input record has been read, or (2) an output record 
in EBCDIC code be converted to ASCII code before the record is written. 
requests user totaling facility. T cannot be specified for a SYSIN or sysout 
data set. 
for 1403 or 3211 Printers with the Universal Character Set (UCS) feature 
and for the 3800, permits data checks and allows analysis by an appropriate 
error analysis routine. If U is omitted, data checks are not recognized as 
errors. 
for MSS, requests window processing to reduce the amount of staging space 
required to process large sequential data sets. The DCB DSORG must be 
PS, the allocation must be in cylinders, and the type of I/O accessing must 
be INPUT only or OUTPUT only. 
requests a validity check for write operations on direct access devices and 
the IBM 3480 Magnetic Tape Subsystem. 
for magnetic tape input, requests that the control program shorten its 
normal error recovery procedure. When specified, a data check is 
considered permanent after five unsuccessful attempts to read a record. 
OPTCD = Z is ignored if chained scheduling is used. 
EXCP: OPTCD=Z 
Z for magnetic tape input, requests that the control program shorten its 
normal error recovery procedure. When specified, a data check is 
considered permanent after five unsuccessful attempts to read a record. 
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Access Method 


G 
DCB A 
Subparameters M|M|M/|MIM/ P|M|M|MIM 


OPTCD 
(continued) 
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Description of Subparameters 
QISAM: OPTCD = {[T][L][M][RI[U][WITY}} 


I requests that ISAM use the independent overflow areas for overflow 
records. 


L requests that ISAM delete records that have a first byte of all ones. These 
records can be deleted when space is required for new records. To use the 
delete option, the DCB RKP must be greater than zero for fixed-length 
records and greater than four for variable-length records. 


requests that the system create and maintain one or more master indexes, 
according to the number of tracks specified in the DCB NTM 
subparameter. 


requests that the control program place reorganization criteria information 
in the DCB. The problem program can analyze these statistics to determine 
when to reorganize the data set. 


requests that the system accumulate track index entries in storage and write 
them as a group for each track of the track index. U can be specified only 
for fixed-length records. 


W _ requests a validity check for write operations on direct access devices. 
Y 


requests that the system use the cylinder overflow areas for overflow 
records. 


Default: R, whenever the OPTCD subparameter is omitted from all sources. 
TCAM: OPTCD = {C|U|W} 


specifies that one byte of the work area indicates if a segment of a message 
is the first, middle, or last segment. 


specifies that the work unit is a message. If U is omitted, the work unit is 
assumed to be a record. 


specifies that the name of each message source is to be placed in an 8-byte 
field in the work area. 


(INILN]) 
PCI= | ((RILR)) 
((AJLAD) 
([X][-X)) 


Specifies (1) whether or not a program-controlled interruption (PCI) is to be used 
to control the allocation and freeing of buffers and (2) how these operations are 
to be performed. The first operand applies to receiving operations and the second 
to sending operations. 

N _ specifies that no PCIs are taken while filling buffers during receiving 
operations or emptying buffers during sending operations. 

R___ specifies that after the first buffer is filled or emptied, a PCI occurs during 
the filling or emptying of each succeeding buffer. The completed buffer is 
freed, but no new buffer is allocated to take its place. 
specifies that after the first buffer is filled or emptied, a PCI occurs during 
the filling or emptying of the next buffer. The first buffer is freed, and a 
buffer is allocated to take its place. 
specifies that after a buffer is filled or emptied, a PCI occurs during the 
filling or emptying of the next buffer. The first buffer is not freed, but a 
new buffer is allocated. 


You can omit the parentheses if you code only the first operand. 
Default: (A,A) 


Note: Do not code the PCI subparameter with DCB subparameter NTM, or DD 
parameters DDNAME, QNAME. 


Access | Access Method = 


G 
DCB A 
Subparameters M!|M|M/M/M]|P |M|MIM|IM 


PRTSP 
| 
| 
| 


RECFM xX} |X]xX} [xX] [X}]x]x 
| 
| 


RESERVE 
| 
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Description of Subparameters 
PRTSP = {0/1/2/3} 


Specifies the line spacing for an online printer. PRTSP is valid only for an online 
printer and only if the RECFM is not A or M. PRTSP=2 is ignored if specified 
with the DD SYSOUT parameter. 


0 - spacing is suppressed, 1 - single, 2 - double, 3 - triple spacing 
JES2 ignores PRTSP for sysout data sets. 
Default: 1 


Note: Do not code the PRTSP subparameter with DCB subparameters 
KEYLEN, MODE, STACK, TRTCH, or DD parameters DDNAME, KEYLEN, 
QNAME. 


RECFM = format 


Information for the DCB RECFM keyword subparameter is moved to the DD 
RECFM parameter described on page 10-136. 


RESERVE = (bytes1,bytes2) 
Specifies the number of bytes (0 through 255) to be reserved in a buffer for 


insertion of data by the DATETIME and SEQUENCE macros. 


bytes] indicates the number of bytes to be reserved in the first buffer that 
receives an incoming message. 


bytes2 indicates the number of bytes to be reserved in all the buffers 
following the first buffer in a multiple-buffer header situation. 
Default: (0,0) 


Note: Do not code the RESERVE subparameter with DCB subparameters 
CYLOFL, RKP, or DD parameters DDNAME, KEYOFF, QNAME, UCS. 


RKP = number 


With SMS, use the DD KEYOFF or DATACLAS parameter. 


Specifies the position of the first byte of the record key in each logical record. 
The first byte of a logical record is position 0. 


If RKP =0 is specified for blocked fixed-length records, the key begins in the first 
byte of each record. OPTCD=L must not be specified. 


If RKP=0 is specified for unblocked fixed-length records, the key is not written 
in the data field. OPTCD=L can be specified. 


For variable-length records, the relative key position must be 4 or greater, if 
OPTCD =L is not specified; the relative key position must be 5 or greater, if 
OPTCD = L is specified. 


For EXCP processing, RKP can be coded but is ignored. 
Default: 0 


Note: Do not code the RKP subparameter with DCB subparameter RESERVE, 
or DD parameters DDNAME, FCB, KEYOFF, UCS. 
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Access Method 


DCB 
Subparameters Description of Subparameters 


STACK STACK = {1/2} 


Specifies which stacker bin is to receive a card. 


Default: 1 


Note: Do not code the STACK subparameter with DCB subparameters 
KEYLEN, PRTSP, TRTCH, or DD parameters DDNAME, KEYLEN, 


THRESH X | THRESH = on 
Specifies the percentage of the nonreusable disk message queue records that are to 
be used before a flush closedown occurs. 
Default: Closedown occurs when 95 percent of the records have been used. ) 
Note: Do not code the THRESH subparameter with DCB subparameter CPRI, 
or DD parameters DDNAME, OUTLIM, QNAME. 


x| |x x| | TRICH={C|E|TIET} 
Specifies the recording technique for 7-track tape. 
C specifies data conversion, odd parity, and no translation. 
E specifies no data conversion, even parity, and no translation. 
T specifies no data conversion, odd parity, and that BCD to EBCDIC 
| translation is required when reading and EBCDIC to BCD translation 
| when writing. 
specifies no data conversion, even parity, and that BCD to EBCDIC Ss) 
translation is required when reading and EBCDIC to BCD translation 
when writing. 
Default: no conversion, odd parity, and no translation. 
Note: Do not code the TRTCH subparameter with DCB subparameters 
KEYLEN, MODE, PRTSP, STACK, or DD parameters DDNAME, KEYLEN, 
QNAME. 
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DDNAME Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the DDNAME parameter to postpone defining a data set until later in the same 
job step. A DDNAME parameter on a DD statement in a cataloged or in-stream procedure 
allows you to postpone defining the data set until a job step calls the procedure; the data set 
must be defined in the calling job step. 


Syntax: 


DDNAME=ddname 


Subparameter Definition 


ddname 
Refers to a later DD statement that defines the data set. ddname must match the ddname 
of the referenced DD statement. 


A job step or procedure step can contain up to five DD statements with DDNAME 
parameters. Each DDNAME parameter must refer to a different DD statement. 


Overrides 


If any DCB subparameter appears on both DD statements, the DCB subparameter on the 
referenced DD statement overrides the DCB subparameter on the DD statement that contains 
DDNAME. 


Relationship to Other Parameters 


The only DD parameters you can code with the DDNAME parameter are: 


| DCB=BLKSIZE LIKE 
| DCB=BUFNO REFDD 
DCB=DIAGNS 


Do not code the DDNAME parameter on a DD statement with a ddname of JOBLIB, 
JOBCAT, or STEPCAT. 


Location in the JCL 


Place a DD statement containing a DDNAME parameter in a job step or in a cataloged or 
in-stream procedure. The referenced DD statement must be later in the same job step, must be 
in the calling job step, or must be in a cataloged or in-stream procedure called by the job step. 


| Location of DD Statements for Concatenated Data Sets: To concatenate data sets to a data set 
| defined with a DDNAME parameter, the unnamed DD statements must follow the DD 

| statement that contains the DDNAME parameter, not the referenced DD statement that 

| defines the data set. 
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Errors in Location of Referenced DD Statement: The system treats a DDNAME parameter as 
through it were a DUMMY parameter and issues a warning message in the following cases: 


e If the job step or called procedure does not contain the referenced DD statement. 
@ Ifthe referenced DD statement appears earlier in the job step. 


Location of DD Statement Requesting Unit Affinity: To use the same device, a DD statement 
can request unit affinity to an earlier DD statement by specifying UNIT=AFF=ddname. Ifa 
DD statement requests unit affinity to a DD statement containing a DDNAME parameter, the 
DD statement requesting unit affinity must be placed after the referenced DD statement. If the 
DD statement requesting unit affinity appears before, the system treats the DD statement 
requesting unit affinity asa DUMMY DD statement. 


//STEP EXEC PGM=TKM 


//DD1 ~=DD DDNAME=DD4 

//DD2 DD DSNAME=A , DISP=OLD 

//DD4 DD DSNAME=B , DISP=OLD - 
//DD5 + DD UNIT=AFF=DD1 


DD1 postpones defining the data set until DD4. DD5 requests unit affinity to DD1. Because 
DD1 has been defined when DD5 is processed, the system assigns DDS to the same device as 
DD1. 


Instead of specifying UNIT = AFF =ddname, both DD statements can specify the same devices 
in their UNIT parameters or the same volume serials in their VOLUME parameters. 


Referenced DD Statement 


If the DDNAME parameter appears in a procedure with multiple steps, the ddname on the 
referenced DD statement takes the form stepname.ddname. For example, if procedure step 
STEPCP1 contains: 


//INDATA DD DDNAME=DD1 


The referenced DD statement in the calling job step is: 


//STEPCP1.DD1 DD * 


Parameters not Permitted on the Referenced DD Statement: The referenced DD statement must 
not contain a DYNAM parameter. 


A DD statement that contains a DDNAME parameter must not override a procedure sysout 


DD statement that contains an OUTPUT parameter if the referenced DD statement also 
contains an OUTPUT parameter. 
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Backward References 


A backward reference is a reference to an earlier DD statement in the job or in a cataloged or 
in-stream procedure called by a job step. A backward reference is in the form *.ddname or 

* stepname.ddname or *.stepname.procstepname.ddname. The ddname in the reference is the 
ddname of the earlier DD statement. If the earlier DD statement contains a DDNAME 
parameter, the reference is to the ddname in the name field of the earlier statement, not to the 
ddname in the DDNAME parameter. 


The DD statement referenced ina DDNAME parameter cannot refer to a DD statement 
between the statement containing the DDNAME parameter and itself. For example: 


//SHOW EXEC PGM=ABLE 


//DD1 DD DDNAME=INPUT 

/ /DD2 DD DSNAME=TEMPSPAC,SPACE=(TRK,1),UNIT=SYSDA 

//DD3 DD DSNAME=INCOPY,VOLUME=REF=*.DD1, 

T7 DISP=(,KEEP) ,SPACE=(TRK, (5,2) ) 

//DD4 DD DSNAME=OUTLIST,DISP=OLD 

//DD5 DD DSNAME=MESSAGE ,DISP=OLD,UNIT=3330,VOLUME=SER=3 33333 
//INPUT DD DSNAME=NEWLIST,DISP=(OLD, KEEP) , VOLUME=SER=333333, 
// UNIT=3330 


The DDNAME parameter on DDI refers to DD statement INPUT. The VOLUME parameter 
of DD3 specifies a backward reference to DDI, which is the name field ddname. 


DD statement INPUT identifies the volume 333333 in its VOLUME = SER = 333333 parameter. 
DD statement INPUT cannot use a backward reference to the VOLUME parameter on DD5 
because DD5 is between the referring DD1 and the referenced INPUT. 


Examples of the DDNAME Parameter 


The following procedure step is the only step in a cataloged procedure named CROWE: 
//PROCSTEP EXEC PGM=RECPGM 


7 /DD1 DD DDNAME=WKREC 
//POD DD DSNAME=OLDREC ,DISP=OLD 


DD statement DD1 is intended for weekly records in the input stream; these records are 
processed by this step. Because the * and DATA parameters cannot be used in cataloged 
procedures, the DDNAME parameter is coded to postpone defining the data set until the 
procedure is called by a job step. The step that calls the procedure is: 


//STEPA EXEC PROC=CROWE 
//WKREC DD * 
data 


f® 
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When the procedure contains multiple steps, use the form stepname.ddname for the ddname of 
the referenced DD statement. For example, the following procedure steps appear in a cataloged 
procedure named PRICE: 


//STEP1 EXEC PGM=SUGAR 
//DD1 DD DDNAME=QUOTES 


//STEP2 EXEC PGM=MOLASS 
//DD2 DD DSNAME=WEEKB,DISP=OLD 


The step that calls the procedure 1s: 


//STEPA EXEC PROC=PRICE 

//STEP1.QUOTES DD * 
data 

f* 


When the referenced DD statement is to be a concatenation, the procedure must already 
contain the concatenation. (Such as when the referencing DD statement is to contain instream 
data.) For example, the following procedure step appears in cataloged procedure NEWONE. 


//NEWONE PROC 

//STEP1 EXEC PGM=TRYIT 

//DD1 DD DDNAME=INSTUFF 

// DD DSN=OLDSTUFF , DISP=OLD 


The step that calls the procedure is: 


//STEPA EXEC PROC=NEWONE 
//STEP1.INSTUFF DD * 


data 
Fg 


The instream data (DDNAME=INSTUFF) is inserted before OLDSTUFF in the 
concatenation. 
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DEST Parameter 


Parameter Type: Keyword, optional 
Purpose: Use the DEST parameter to specify a destination for a sysout data set. The DEST 
parameter can send a sysout data set to a remote or local terminal, a node, a node and remote 


work station, a local device or group of devices, or a node and userid. 


Note: Code the DEST parameter only on a DD statement with a SYSOUT parameter. 
Otherwise, the system checks the DEST parameter for syntax, then ignores it. 


Syntax: 


DEST=destination 


The destination subparameter for JES2 is one of the following: 


LOCAL 
name 
Nnonnn 
NnonRmmmm 
NnnnRmmm 
NnonnnRmm 
Rnnnn 
RMnnnn 
RMTnnnn 
Unnnn 
(node,userid) 


The destination subparameter for JES3 is one of the following: 


ANYLOCAL 
device-name 
device-number 
group-name 
nodename 
(node,userid) 


Subparameter Definition for JES2 Systems 


LOCAL 
Indicates any local device. 


name 
Identifies a local or remote device by a symbolic name defined by the installation during 
JES2 initialization. The name is 1 through 8 alphanumeric or national ($, #, @) 
characters. 


Nnnnn 
Identifies a node. nnnn 1s 1 through 4 decimal numbers from 1 through 1000. 
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NnonRmmmm 
NonnRmmm J 
NnononRmm 

Identifies a node and a remote work station connected to the node. The node number, 

indicated in the format by n, is | through 4 decimal numbers from 1 through 1000. The 

remote work station number, indicated in the format by m, is 1 through 4 decimal 


numbers from 1 through 9999. Do not code leading zeros in n orm. The maximum 
number of digits for n and m combined cannot exceed six. 


Note: RO is equivalent to specifying LOCAL at node Nn. 


Rnonnn 

RMnnnn 

RMTnnonn 
Identifies a remote terminal. nnnn is | through 4 decimal numbers from | through 9999. 
Note that with remote pooling, the installation may translate this route code to another 


route code. ) 


Note: RO 1s equivalent to LOCAL. 


Unnnn 
Identifies a local terminal with special routing. nnnn is 1 through 4 decimal numbers 
from | through 9999. 


(node,userid) 
Identifies a node and a TSO or VM userid at that node. The node is a symbolic name 
defined by the installation during initialization; node is 1 through 8 alphanumeric or 2 
national ($, #, @) characters. The userid must be defined at the node; userid for TSO is 
1 through 7 alphanumeric or national ($, #, @) characters and for VM is | through 8 
alphanumeric or national ($, #, @) characters. 


A userid requires a node; therefore, code DEST =(node,userid). You cannot code a 
userid without a node. 


DEST = (node) is valid with a writer-name subparameter in the SYSOUT parameter; 
however, DEST = (node,userid) is invalid. Therefore, you can code 
SYSOUT = (A,writer-name), DEST = (node). 


Note: If a data set is queued for transmission and an operator changes its destination, 
the userid portion of the routing is lost. 


Subparameter Definition for JES3 Systems 


ANYLOCAL 
Indicates any local device that is attached to the global processor. 


device-name 
Identifies a local device by a symbolic name defined by the installation during JES3 


initialization. device-name is | through 8 alphanumeric or national ($, #, @) characters. 


device-number ; 
Identifies the 3-character device number. | ) 
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group-name 
Identifies a group of local devices, an individual remote station, or a group of remote 
stations by a symbolic name defined by the installation during JES3 initialization. 
group-name is | through 8 alphanumeric or national ($, #, @) characters. 


nodename 
Identifies a node by a symbolic name defined by the installation during JES3 
initialization. nodename is | through 8 alphanumeric or national ($, #, @) characters. If 
the nodename you specify is the same as the node you are working on, JES3 treats the 
output as though you specified ANYLOCAL. 


(node, userid) 
Identifies a node and a TSO or VM userid at that node. The node is a symbolic name 
defined by the installation during initialization; node is | through 8 alphanumeric or 
national ($, #, @) characters. The userid must be defined at the node; userid for TSO is 
1 through 7 alphanumeric or national ($, #, @) characters and for VM is | through 8 
alphanumeric or national ($, #, @) characters. 


A userid requires a node; therefore, code DEST =(node,userid). You cannot code a 
userid without a node. 


DEST = (node) is valid with a writer-name subparameter in the SYSOUT parameter: 


however, DEST = (node, userid) is invalid. Therefore, you can code 
SYSOUT = (A, writer-name), DEST = (node). 


If you do not code a DEST parameter, JES directs the sysout data set to the default destination 
for the input device from which the job was submitted. 


If a specified destination is invalid, the job fails. 


The DEST parameter on the sysout DD statement overrides an OUTPUT JCL DEST 
parameter. 


Relationship to Other Parameters 


Code the DEST parameter only on a DD statement with the SYSOUT parameter. 


Relationship to Other Control Statements 


You can also code an output destination using: 

e The OUTPUT JCL statement. 

e The JES2 /*OUTPUT and /*ROUTE control statements. 

e The JES3 //*MAIN, //*FORMAT PR, and //*FORMAT PU control statements. 


Because DEST = (node,userid) cannot be coded on JES2 or JES3 control statements, you must 
code it, if needed, on a DD or OUTPUT JCL statement. 
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Examples of the DEST Parameter 


//JOBO1 JOB 


,'MAE BIRD' ,MSGCLASS=B 


//STEP1 EXEC PGM=INTEREST 


//DEBIT DD 
//CALIF DD 
/ /FLOR DD 


SYSOUT=A 
SYSOUT=A, DEST=R555 
SYSOUT=A, DEST=(BOCA,'9212U28') 


In this example, the system sends the sysout data set defined by DD statement DEBIT to the 
work station that submitted the job, the data set defined by DD statement CALIF to the 
remote terminal 555, and the data set defined by DD statement FLOR to VM userid 9212U28 


at node BOCA. 
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DISP Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the DISP parameter to describe the status of a data set to the system and tell the 
system what to do with the data set after termination of the step or job. You can specify one 
disposition for normal termination and another for abnormal termination. 


Note: Disposition of the data set is controlled solely by the DISP parameter; disposition of the 
volume(s) on which the data set resides is a function of the volume status when the volume is 
demounted. 


References: For information about tape data set processing, see Magnetic Tape Labels and File 
Structure Administration. 


Syntax: 


DISP=status 
DISP=([status] [,normal-termination-disp] [,abnormal-termination-disp] ) 


NEW]|,DELETE | [,DELETE 
OLD 

SHR 

MOD | |, CATLG , UNCATLG 
; , UNCATLG 


4 


You can omit the parentheses if you code only the status subparameter. 


If you omit the status subparameter but code subparameters for normal or abnormal 
termination disposition, you must code a comma to indicate the absence of NEW. For 
example, DISP=(,KEEP) or DISP=(,CATLG,DELETE). 


If you omit the second subparameter but code the third, you must code a comma to 
indicate the absence of the second subparameter. For example, 
DISP = (OLD,,DELETE) or DISP =(,,KEEP). 


Subparameter Definition 


Status Subparameter 


NEW 
Indicates that a new data set is to be created in this step. 


OLD 


Indicates that the data set exists before this step and that this step requires exclusive 
(unshared) use of the data set. 
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If you specify DISP=OLD for an output tape data set and (1) the data set is not 
protected by RACF or a password or (2) the data set has no expiration date, the system 
does not verify the data set name in the header label. 


SHR 
Indicates that the data set exists before this step and that another job can share it, that is, 
use it at the same time. This subparameter can also be coded as SHARE. 


If you specify DISP=SHR for an output tape data set and (1) the data set is not 
protected by RACF or a password or (2) the data set has no expiration date, the system 
does not verify the data set name in the header label. 


MOD 
Indicates one of the following: 


e The data set exists. Records are to be added to the end of the data set. The data set 


must be sequential. j 


e A new data set is to be created. 
In either case, MOD specifies exclusive (unshared) use of the data set. 


When the data set is opened, the read/write mechanism is positioned after the last 
sequential record for an existing data set or at the beginning for a new data set. For 
subsequent OPENs within the same step, the read/write mechanism is positioned after the 
last sequential record. 


Note: You cannot specify DISP=MOD to extend ISO/ANSI/FIPS Version 3 tape data J 
sets, unless the ISO/ANSI/FIPS Version 3 label validation installation exit allows the 

extension. For information on using ISO/ANSI/FIPS Version 3 installation exits, see 

Magnetic Tape Labels and File Structure Administration. 


To use DISP= MOD to create a new data set, specify the following: 


e No VOLUME=SER or VOLUME=REF parameter on the DD statement. The 
data set must not be cataloged or passed from another job step. ) 


e A VOLUME=REF parameter that refers to a DD statement that makes a 
nonspecific volume request. One of the following must also be true: 


— The DSNAME parameters in the two DD statements must be different. 
— The two DD statements must request different areas of the same ISAM data set. 


A nonspecific volume request is a DD statement for a new data set that can be 
assigned to any volume or volumes. 


Note: For a new generation of a generation data group (GDG) data set (where (+n) 
is greater than 0), VOLUME=REF or VOLUME=SER can be coded. 


After the system chooses a volume for a new data set, if the system finds another data set 
with the same name on that volume, the system will try to allocate a different volume. 
However, SMS-managed data sets require unique data set names. If a new data set is 
chosen to be SMS-managed and an existing SMS-managed data set has the same data set 
name, the request is failed. 
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In a JES3 system, if you code DISP= MOD for a multivolume data set and any of the 
volumes are JES3-managed, JES3 will not execute the job until all volumes, including 
scratch volumes being added, are allocated. Such a job will wait on the queue until all 
volumes are allocated. 


Normal Termination Disposition Subparameter 


DELETE 
Indicates that the data set’s space on the volume is to be released if this step terminates 
normally. The space can be used for other data sets; the data set is not erased from the 
space. 


An existing data set is deleted only if its retention period or expiration date has passed; 
otherwise the data set is kept. A new data set is deleted at the end of the step even 
though a retention period or expiration date is also specified. See the DD EXPDT or 
RETPD parameters. 


If the system retrieves volume information from the catalog because the DD statement 
does not specify VOLUME=SER or VOLUME=REF, then DELETE implies 
UNCATLG: the system deletes the data set and removes its catalog entry. 


KEEP 
Indicates that the data set is to be kept on the volume if this step terminates normally. 


Without SMS, only KEEP is valid for VSAM data sets. VSAM data sets should not be 
passed, cataloged, uncataloged, or deleted. 


With SMS, all dispositions are valid for VSAM data sets; however, UNCATLG 1s 
ignored. 


For new SMS-managed data sets, KEEP implies CATLG. 


PASS 
Indicates that the data set is to be passed for use by a subsequent step in the same job. 


With SMS, the system replaces PASS with KEEP for permanent VSAM data sets. When 
you refer to the data set later in the job, the system obtains data set information from the 
catalog. 


Note: A data set can be passed only within a job. 


CATLG 
Indicates that, if the step terminates normally, the system is to place an entry pointing to 
the data set in the system or user catalog. For CVOL catalogs, the system creates any 
missing index levels. Note that the data set is kept. 


An unopened tape data set is cataloged, unless the volume request is nonspecific or unless 
the data set is allocated to a dual-density tape drive but no density is specified. A 
nonspecific volume request is a DD statement for a new data set that can be assigned to 
any volume or volumes. 


For information about the rules for cataloged data set names, refer to Integrated Catalog 


Administration: Access Method Services Reference or VSAM Catalog Administration: 
Access Method Services Reference. 
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UNCATLG 
Indicates that, if the step terminates normally, the system is to delete (1) the entry J 
pointing to the data set in the system or user catalog and (2) unneeded indexes, except for 
the highest level entry. Note that the data set is kept. 


With SMS, UNCATLG is ignored for SMS-managed data sets and VSAM data sets 
(KEEP is implied). 


Abnormal Termination (Conditional) Disposition Subparameter 


DELETE 
Indicates that the data set’s space on the volume is to be released if this step terminates 
abnormally. The space can be used for other data sets; the data set is not erased from 
the space. 


An existing data set is deleted only if its retention period or expiration date has passed; 

otherwise the data set is kept. If the data set was being created when the step abnormally | 
terminates, the data set is deleted even though it has an unexpired retention period or S 
expiration date. See the DD EXPDT or RETPD parameters. 


If the system retrieves volume information from the catalog because the DD statement 
does not specify VOLUME=SER or VOLUME=REF, then DELETE implies 
UNCATLG: the system deletes the data set and removes its catalog entry. 


For a cataloged, passed data set, the user catalog is not updated. 


KEEP 
Indicates that the data set is to be kept on the volume if this step terminates abnormally. 2S) 


Without SMS, only KEEP is valid for VSAM data sets. VSAM data sets should not be 
passed, cataloged, uncataloged, or deleted. 


With SMS, all dispositions are valid for VSAM data sets; however, UNCATLG is 
ignored. 


For new SMS-managed data sets, KEEP implies CATLG. 


CATLG 
Indicates that, if the step terminates abnormally, the system is to place an entry pointing 
to the data set in the system or user catalog. For CVOL catalogs, the system creates any 
missing index levels. Note that the data set is kept. 


An unopened tape data set is cataloged, unless the volume request is nonspecific or unless 
the data set is allocated to a dual-density tape drive but no density is specified. 


For a cataloged, passed data set, the user catalog is not updated. A passed, not received 
data set is not cataloged if the data set name has a first-level qualifier of a catalog name 
or alias. 


UNCATLG 
Indicates that, if this step terminates abnormally, the system is to delete (1) the entry 


pointing to the data set in the system or user catalog and (2) unneeded indexes, except for 
the highest level entry. Note that the data set is kept. j 
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For a cataloged, passed data set, the user catalog is not updated. 


With SMS, UNCATLG is ignored for SMS-managed data sets and VSAM data sets 
(KEEP is implied). 


Defaults 


e If you omit the status subparameter, the default is NEW. 


e If you omit the normal termination disposition subparameter, the default is DELETE for a 
NEW data set or KEEP for an existing data set. 


e If you omit the abnormal termination disposition subparameter, the default is the 
disposition specified or implied by the second subparameter. However, if the second 
subparameter specified PASS, the default abnormal termination disposition is DELETE for 
a NEW data set or KEEP for an existing data set. 


e Ifyou omit the DISP parameter, the default is a NEW data set with a disposition of 
DELETE for both normal and abnormal termination disposition. Thus, you can omit the 
DISP parameter for a data set that is created and deleted during a step. 


Relationship to Other Parameters 


Do not code the following parameters with the DISP parameter. 


| * 

| BURST 
CHARS 
COPIES 
DATA 


DDNAME SYSOUT 
DYNAM 

FLASH 

MODIFY 

QNAME 


Disposition of QSAM Data Sets 


Do not code DISP= MOD if the data control block (DCB) specifies RECFM = FBS and the 
data set is processed by QSAM. If you do and a block is shorter than the specified block size, 
QSAM assumes that the short block is the last block and starts end-of-file processing. By this 
action, QSAM can embed short blocks in your data set and so affect the number of records per 


track. 


| Disposition of Generation Data Sets 


| See Appendix B in JCL User's Guide for additional information about disposition processing 
| for generation data sets. 


Disposition of Temporary Data Sets 


Specify a normal termination disposition of PASS or DELETE for a temporary data set or for 
a data set with a system-generated name, that is, when a DSNAME parameter is omitted from 
the DD statement. 


For a temporary data set name, the system ignores any abnormal termination disposition 
specified in the third subparameter. 
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Disposition of Partitioned Data Sets 


When you specify DISP= MOD or DISP= NEW for a partitioned data set and you also specify J 
a member name in the DSNAME parameter, the member name must not already exist. If the 
member name already exists, the system terminates the job. 


When you specify DISP=OLD for a partitioned data set and you also specify a member name 
in the DSNAME parameter, the data set must already exist. If the member name already exists 
and the data set is opened for output, the system replaces the existing member with the new 
member. If the member name does not already exist and the data set is opened for output, the 
system adds the member to the data set. 


When you specify DISP= MOD for a partitioned data set and you do not specify a member 
name, the system positions the read/write mechanism at the end of the data set. The system 
does not make an automatic entry into the directory. 


When you specify DISP= MOD for a partitioned data set and you do specify a member name, 
the system positions the read/write mechanism at the end of the data set. If the member name } 
already exists, the system terminates the job. 


DISP = MOD for a Multivolume Data Set 


When you code DISP=MOD and the volume information is for a multivolume data set, 

normally the first volume(s) will be mounted on the devices(s) allocated. Then, if the data set is 

opened for output, OPEN starts with the last volume. If the number of volumes is more than 

the number of allocated devices, the system asks the operator to demount the first volume(s) , 
and mount the last. To have the last volume mounted without first mounting and then J 
demounting the first volume(s): 


e For DASD, code DEFER in the UNIT parameter or a volume sequence number in the 
VOLUME parameter. If you code VOLUME=REF, you must also code either DEFER in 
the UNIT parameter or a volume sequence number in the VOLUME parameter. 


e For tape, code VOLUME=REF or DEFER in the UNIT parameter or a volume sequence 
number in the VOLUME parameter. 


When you code DISP=MOD for a multivolume tape data set, use the volume count and J 
volume sequence number subparameters of the VOLUME parameter to keep the system from 
positioning the read/write mechanism after the last record on the last volume. For example: 


//DDEX1 DD DSNAME=OPER.DATA,DISP=(MOD,KEEP) , VOLUME=(,,1,2) 


The volume sequence number of 1 specifies that you want to use the first volume, and the 
volume count of 2 specifies that the data set requires two volumes. 


If you want to extend a cataloged, multivolume data set and have it properly cataloged after it 
is kept or passed, code the VOLUME and UNIT parameters to make the system use the values 
in the system catalog to process the data set. The following DD statement shows how to keep 
and extend a cataloged multivolume data set using the system catalog. Remember that this 
data set was created with a volume count of 2. 


//DDEX2 DD DSNAME=OPER.DATA,DISP=(MOD,KEEP), , 
Jf VOLUME=(,,,3) ,UNIT=(,P) ) 
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The VOLUME parameter references the system catalog for volume information about the data 
set and increases the maximum number of volumes for OPER.DATA. Because the UNIT 
parameter requests parallel mounting, the system must allocate the same number of units as the 
number of volumes in the VOLUME parameter; in this case, 3. 


The following is an example of the messages in the job log after the job completes. 


IEF285I OPER.DATA KEPT 
IEF285I VOL SER NOS= 333001,333002,333003. 
IEF285I1 OPER.DATA RECATALOGED 


ITEF2851 VOL SER NOS= 333001,333002,333003. 


If you do not reference the system catalog when extending cataloged multivolume data sets, the 
system does not update the system catalog with the newly referenced volumes. 


Effect of DCB =dsname Parameter 


If the DCB parameter refers to a cataloged data set, the system obtains the volume sequence 
number from the label of the data set, unless the volume sequence number is coded on the DD 
statement. 


Thus, for the following DD statement, even though DISP= MOD is specified, the system 
positions the read/write mechanism after the last record on the volume specified in the volume 
sequence number in the label; this volume may or may not be the last volume. 


//DD1 DD DSNAME=MULTI1,DISP=MOD , DCB=CATDD 


To control which volume is processed, code a volume sequence number. 


//DD2 DD DSNAME=MULTI2 , DISP=MOD , DCB=CATDD , VOLUME=(, ,2) 
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Summary of Disposition Processing 


DISP Subparameters: 


Normal 


Termination 
Disposition 


treated as 
new 


UNCATLG 


NEW 
temporary 
data set 


Figure 10-1 (Part 1 of 2). 
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Figure 10-1 (Part 2 of 2). Summary of Disposition Processing 
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Examples of the DISP Parameter 


//DD2 DD DSNAME=FIX,UNIT=3420-1,VOLUME=SER=44889, 
ve, DISP=(OLD, , DELETE) 


DD statement DD2 defines an existing data set and implies by the omitted second 
subparameter that the data set is to be kept if the step terminates normally. The statement 
requests that the system delete the data set if the step terminates abnormally. 


//STEPA EXEC PGM=FILL 

//DD1 DD DSNAME=SWITCH.LEVEL18.GROUP12 ,UNIT=3350, 
VOLUME=SER=LOCAT3 , SPACE=(TRK, (80,15) ) ,DISP=(,PASS) 

//STEPB EXEC PGM=CHAR 


/ /DD2 DD DSNAME=XTRA,DISP=OLD 

//DD3 DD DSNAME=*.STEPA.DD1,DISP=(OLD,PASS,DELETE) 
//STEPC EXEC PGM=TERM 

//DD4 DD DSNAME=*.STEPB.DD3,DISP=(OLD,CATLG, DELETE) 


DD statement DD1 defines a new data set and requests that the data set be passed. If STEPA 
abnormally terminates, the data set is deleted because it is a new data set, the second 
subparameter is PASS, and an abnormal termination disposition is not coded. 


DD statement DD3 in STEPB receives this passed data set and requests that the data set be 
passed. If STEPB abnormally terminates, the data set is deleted because of the third 
subparameter of DELETE. 


DD statement DD4 in STEPC receives the passed data set and requests that the data set be 
cataloged at the end of the step. If STEPC abnormally terminates, the data set is deleted 
because of the abnormal termination disposition of DELETE. 


DD statement DD2 defines an old data set named XTRA. When STEPB terminates, normally 
or abnormally, this data set is kept. 


//SMSDD5 DD DSNAME=MYDS5.PGM, DATACLAS=DCLASO5,STORCLAS=SCLASO5, 
// DISP= (NEW, KEEP) 


DD statement SMSDD5 defines a new SMS-managed data set and requests that the data set be 
kept (which implies that it be cataloged). 


//SMSDD7 DD DSNAME=MYDS7.PGM,DISP=(OLD,UNCATLG) 
DD statement SMSDD7 defines an existing SMS-managed data set (the data set had been 


assigned a storage class when it was created) and requests that the data set be uncataloged. 
However, the data set is kept because UNCATLG is ignored for SMS-managed data sets. 
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DLM Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the DLM parameter to specify a delimiter to terminate this in-stream data set. 
When the DLM parameter assigns a different delimiter, the in-stream data records can include 
standard delimiters, such as /* and //, in the data. 


In a JES2 system, when the DLM delimiter appears on a DD * statement, either the assigned 
delimiter or // ends the input data set. When the DLM delimiter appears on a DD DATA 
statement, only the assigned delimiter ends the input data set. 


In a JES3 system, when the DLM delimiter appears on either a DD * or DD DATA statement, 
only the assigned delimiter ends the input data set. 


Note: When the DLM delimiter overrides any implied delimiter, you must terminate the data 
with the DLM characters. Otherwise, the system keeps reading until the reader is empty. 


Except for the JES2 /*SIGNON and /*SIGNOFF statements, the system does not recognize 
JES2 and JES3 statements in an input stream between the DLM parameter and the delimiter it 
assigns. The JES2 /*SIGNON and /*SIGNOFF statements are processed by the remote work 
station regardless of any DLM delimiter. 


Syntax: 


DLM=delimiter 


e If the specified delimiter contains any special characters, enclose it in apostrophes. In 
this case, a special character is any character that is neither alphanumeric nor national 


(3, #, @). 


Failing to code enclosing apostrophes produces unpredictable results. 


If the delimiter contains an ampersand or an apostrophe, code each ampersand or 
apostrophe as two consecutive ampersands or apostrophes. Each pair of consecutive 
ampersands or apostrophes counts as one character. 


Subparameter Definition 


delimiter 
Specifies two characters that indicate the end of this data set in the input stream. 
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Default 
If you do not specify a DLM parameter, the default is the /* delimiter statement. J 
If the system finds an error on the DD statement before the DLM parameter, it does not 


recognize the value assigned as a delimiter. The system reads records until it reads a record 
beginning with /* or //. 


Relationship to Other Parameters 
Code the DLM parameter only on a DD statement with the * or DATA parameter. 
The DLM parameter has meaning only on statements defining data in the input stream, that is, 


DD * and DD DATA statements. If DLM is specified on any other statement, a JCL error 
message is issued. 


Invalid Delimiters S) 


If the delimiter is not two characters: 


e For JES2, if only one character is specified, JES2 uses the installation-defined default. If 
more than two characters are specified, JES2 terminates the job. 


@ For JES3, if an incorrect number of characters is coded, JES3 terminates the job. 


Example of the DLM Parameter 


//DD1 DD *,DLM=AA 
data 


AA 


The DLM parameter assigns the characters AA as the delimiter for the data defined in the J 
input stream by DD statement DD1. For JES2, the characters // would also serve as valid 

delimiters since a DD * statement was used. JES3 accepts only the characters specified for the 

DLM parameter as a terminator for DD * or DD DATA. 
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DSID Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the DSID parameter to specify the data set identifier of an input or output data 
set on a diskette of the 3540 Diskette Input/Output Unit. 


An input data set is read from a 3540 diskette by a diskette reader program, and an output data 
set is written on a 3540 diskette by a diskette writer, which is an external writer. Neither JES2 
nor JES3 can read or write diskette data sets. 


To read a data set from a 3540 diskette, the DD statement must contain: 


e A DSID parameter. 
e An * or DATA parameter, to begin the input stream data set. 


To write a data set on a 3540 diskette, the DD statement must contain: 
e A DSID parameter. 


e A SYSOUT parameter that specifies the output class that the diskette writer processes and 
the name of the diskette writer. 


Also, a system command, from the operator or in the input stream, must start the diskette 
writer before this DD statement 1s processed. 


Note: The system ignores the DSID parameter on a DD *, DD DATA, or a DD statement 
with the SYSOUT parameter, except when a diskette reader or writer processes the JCL. 


References: For more information about associated data sets, see JBM 3540 Programmer's 
Reference. External writers are described in SPL: System Modifications. 


Syntax: 


DSID= Jid 
(id, [V]) 


You can omit the parentheses if you code only an id. 


Subparameter Definition 


id 
Specifies the data set identifier. The id is 1 through 8 characters. The characters must be 
alphanumeric, national ($, #, @), a hyphen, or a left bracket. The first character must be 
alphabetic or national ($, #, @). 

V 


Indicates that the data set label must have been previously verified on a 3741 Data 
Station/Workstation. This subparameter is required only on a SYSIN DD statement. 
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Relationship to Other Parameters 


Do not code the following parameters with the DSID parameter. 


BURST FLASH 
CHARS MODIFY 
DDNAME MVSGP 
DYNAM QNAME 


For 3540 Diskette Input/Output Units: A DSID parameter on a DD *, DD DATA, or sysout 
DD statement is ignored except when detected by a diskette reader as a request for an 
associated data set. See JBM 3540 Programmer's Reference. 


On a DD * or DD DATA statement processed by a diskette reader, you can specify DSID, 


VOLUME=SER, BUFNO, and LRECL to indicate that a diskette data set is to be merged 
into the input stream following the DD statement. 


Example of the DSID Parameter 


//JOB1 JOB  ,,MSGLEVEL=(1,1) 
//STEP EXEC PGM=AION 
//SYSIN DD * ,DSID=(ABLE,V) , VOLUME=SER=123456, 


DCB=LRECL=80 
//SYSPRINT DD SYSOUT=E , DCB=LRECL=128 , DSID=BAKER 


In this example, the SYSIN DD statement indicates that the input is on diskette 123456 in data 
set ABLE and must have been verified. The output will be written on a diskette in data set 
BAKER. 
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DSNAME Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the DSNAME parameter to specify the name of a data set. For a new data set, 
the specified name is assigned to the data set; for an existing data set, the system uses the name 
to locate the data set. 


References: Partitioned data sets are described in Data Administration Guide. 


Syntax: 


DSNAME| =name 
DSN 


name for permanent data set: 
dsname 
dsname (member) 
dsname (generation) 
dsname (area) 
for temporary data set: 
&&dsname 
&&dsname (member ) 
&&dsname (area) 
copied from earlier DD statement: 
* .ddname 
*,stepname.ddname 
*,.stepname.procstepname.ddname 


for dummy data set: 


NULLFILE 


You can abbreviate DSNAME as DSN. 


If the data set name begins with a blank character, the system assigns the data set a 
temporary data set name. 


The system ignores blank characters at the end of a data set name. 


Blanks can be included in a data set name if the name is enclosed in apostrophes, such 
as DSNAME=’AB CD’. 


Special Characters: When a data set name contains special characters that are not significant 
to the system, other than hyphens, enclose it in apostrophes. For example, 
DSNAME=’DS/29’. 


Code each apostrophe that is part of the data set name as two consecutive apostrophes. For 
example, code DAYS’END as DSNAME=’DAYS’END’. 
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The following special characters are significant to the system. Do not enclose them in 
apostrophes. 


e@ Periods to indicate a qualified data set name. However, you must enclose in apostrophes 
a period immediately before a right parenthesis, immediately after a left parenthesis, or 
immediately before a comma; for example, DSNAME=’(.ABCY and 
DSNAME="(ABC.)’ and DSNAME=’A.B.C,’, 


Double ampersands to identify a temporary data set name. Note that if you use 
apostrophes, DSNAME=’&&AB’ and DSNAME=’&AB’ refer to the same data set. 


Parentheses to enclose the member name of a partitioned data set, the area name of an 
indexed sequential data set, or the generation number of a generation data set. 


Plus (+) or minus (-) sign to identify a generation of a generation data group. 


e The asterisk to indicate a backward reference. 


On a DD statement in a cataloged or 1n-stream procedure, if the data set name is a symbolic 
parameter, do not enclose it in apostrophes. If it is enclosed in apostrophes, the system 
performs correct substitution only if the symbolic parameter enclosed in apostrophes is 
preceded by a symbolic parameter not enclosed in apostrophes. 


The data set name should not contain the 44 special characters (X’04’) created by the 12-4-9 
multiple punch or any operation that converts the value of characters to X’04’. 


Subparameter Definition 


Data Set Name for Permanent Data Set 


Assign a permanent data set either an unqualified or qualified name: 


Unqualified Name: 1 through 8 alphanumeric or national ($, #, @) characters, a hyphen, or 
a character X’CO0’. The first character must be alphabetic or national ($, #, @). Do not 
use hyphens in data set names for RACF-protected data sets. Do not use national (§, #, 
@) characters in ISO/ANSI/FIPS version 3 tape data set names. For example, 
DSNAME=ALPHA is an unqualified data set name. 


Qualified Name: multiple names joined by periods. Each name is coded like an unqualified 

name; therefore, the name must contain a period every 8 characters or less. For example, 
DSNAME=ALPHA.PGM is a qualified data set name. The maximum length ofa 

qualified data set name is: 

@ 44 characters, including periods. 

e For a generation data group, 35 characters, including periods. 

e For an output tape data set, 17 characters, including periods. If longer than 17 ) 


characters, only the rightmost 17 characters are written to the tape header label. For 
more information, see Magnetic Tape Labels and File Structure Administration. 
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Name for RACF-Protected Data Set: The Resource Access Control Facility (RACF) 
expects the data set name to have a high-level qualifier that 1s defined to RACF. See the 
RACF Security Administrator's Guide for details. RACF Version | Release 7 uses the entire 
data set name, from | through 44 characters, when protecting a tape data set. 


dsname 
Specifies a data set name. 


dsname(member) 
Specifies a permanent partitioned data set name and the name of a member within that 
data set. 


dsname(generation) 
Specifies the name of a generation data group (GDG) and the generation number (zero or 
a signed integer) of a generation data set within the GDG. 


To retrieve all generations of a generation data group, omit the generation number. 


dsname(area) 
Specifies the name of a permanent indexed sequential data set and an area of the data set. 
The area-name is INDEX, PRIME, or OVFLOW. 


If you define an indexed sequential data set on only one DD statement, omit the area 
name or code it as PRIME. For example, DSNAME=dsname or 
DSNAME =dsname(PRIME). 


To retrieve an indexed sequential data set, omit the area name. 
Data Set Name for Temporary Data Set 


A temporary data set is created and deleted within a job. When defining a temporary data set, 
you can code the DSNAME parameter or omit it; if omitted, the system will generate a name 
for the data set. 


SMS manages a temporary data set if you specify a storage class (via the DD STORCLAS 
parameter) or if an installation-written automatic class selection (ACS) routine selects a storage 
class for the temporary data set. 


When coded, the data set name for a temporary data set consists of two ampersands (&&) 
followed by 1 through 8 alphanumeric or national ($, #, @,) characters, a hyphen, or a 
character X’COQ’. The first character following the ampersands must be alphabetic or national 


(3, #, @). 


The system generates a qualified name for the temporary data set. The name begins with SYS 
and includes the job name, the data set name from the DSNAME parameter, if coded, and 
other identifying characters. If several jobs enter the system at the same time and contain DD 
statements with the same temporary data set name or with no data set name, the qualified 
names generated by the system will not be unique. 


Note: A single ampersand before a data set name in a cataloged or in-stream procedure 
signifies a symbolic parameter. However, if no value is assigned to the name on either the 
EXEC statement that calls the procedure or on a PROC statement in the procedure, the system 
treats the name as a temporary data set name. 
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& &dsname 
Specifies the name of a temporary data set. 


& &dsname(member) 
Specifies the name of a temporary partitioned data set and a member within that data set. 


& &dsname(area) 
Specifies the name of a temporary indexed sequential data set and an area of the data set. 
The area name is INDEX, PRIME, or OVFLOW. 


If you define an indexed sequential data set on only one DD statement, omit the area 
name or code it as PRIME. For example, DSNAME= &&dsname or 
DSNAME= &&dsname(PRIME). 


Data Set Name Copied from Earlier DD Statement 


A backward reference is a reference to an earlier statement in the job or in a cataloged or 
in-stream procedure called by this or an earlier job step. A backward reference can be coded in 
the DSNAME parameter to copy a data set name from an earlier DD statement. 


When copying the data set name, the system also copies the following from the DD statement: 


@ Whether or not the data set is a PDS. 
@ Whether or not the data set is a temporary data set. 


*,ddname 
Asks the system to copy the data set name from earlier DD statement ddname. 


*,stepname.ddname 
Asks the system to copy the data set name from DD statement, ddname, in an earlier 
step, stepname, in the same job. 


* stepname. procstepname.ddname 
Asks the system to copy the data set name from a DD statement in a cataloged or 
in-stream procedure. Stepname is the name of this job step or an earlier job step that 
calls the procedure, procstepname is the name of the procedure step that contains the DD 
statement, and ddname is the name of the DD statement. 


Data Set Name for Dummy Data Set 
NULLFILE 


Specifies a dummy data set. NULLFILE has the same effect as coding the DD 
DUMMY parameter. 


Relationship to Other Parameters 


Do not code the following parameters with the DSNAME parameter. 


54 DATA MODIFY 
BURST DDNAME QNAME 

CHARS DYNAM SYSOUT 
COPIES FLASH 


Do not code the DCB IPLTXID subparameter with the DSNAME parameter. 
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With DD AMP Parameter: When you code an AMP parameter for a VSAM data set, do not 
code a DSNAME: 


That contains parentheses, a minus (hyphen), or a plus (+) sign. 
That is in the form for ISAM. 

That is in the form for PAM (partitioned access method). 

That names a generation data group. 


Examples of the DSNAME Parameter 
//DD1 DD DSNAME=ALPHA,DISP=(,KEEP), 
// UNIT=3420 , VOLUME=SER=389984 
DD statement DD1 defines a new data set and names it ALPHA. DD statements in later job 


steps or jobs may retrieve this data set by specifying ALPHA in the DSNAME parameter, unit 
information in the UNIT parameter, and volume information in the VOLUME parameter. 


/ /DDSMS1 DD DSNAME=ALPHA.PGM,DISP=(NEW,KEEP) , DATACLAS=DCLAS1, 
// MGMTCLAS=MCLAS1,STORCLAS=SCLAS 1 


DD statement DDSMS1 defines a new SMS-managed data set and names it ALPHA.PGM. 


DD statements in later job steps or jobs may retrieve this data set by specifying ALPHA.PGM 
in the DSNAME parameter. 


//DD2 DD DSNAME=LIB1(PROG12) ,DISP=(OLD,KEEP) , UNIT=3350 
// VOLUME=SER=8822 34 


DD statement DD2 retrieves member PROG12 from the partitioned data set named LIB1. 
//DD3 DD DSNAME=&&WORK,UNIT=3420 
DD statement DD3 defines a temporary data set. Because the data set is deleted at the end of 


the job step, the DSNAME parameter can be omitted. The following example shows why a 
temporary data set should be named. 


//STEP1 EXEC PGM=CREATE 


//DD4 DD DSNAME=&&ISDATA (PRIME) ,DISP=(,PASS) ,UNIT=(3350,2), 
// VOLUME=SER=334859,SPACE=(CYL, (10,,2) ,,CONTIG) ,DCB=DSORG=IS 
//STEP2 EXEC PGM=OPER 

//DD5 DD DSNAME=* .STEP1.DD4,DISP=(OLD, DELETE) 


DD statement DD4 in STEP! defines a temporary indexed sequential data set named ISDATA. 
This DD statement defines all of the areas of an indexed sequential data set. DD statement 
DD5S in STEP? retrieves the data set by referring to the earlier DD statement that defines the 
data set. Because the temporary data set is passed when it is defined in STEP, it is not deleted 
at the end of STEP1 and STEP2 can retrieve it. 
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DUMMY Parameter 


Parameter Type: Positional, optional 
Purpose: Use the DUMMY parameter to specify that: 


@ No device or external storage space is to be allocated to the data set. 
e No disposition processing is to be performed on the data set. 
e For BSAM and QSAM, no input or output operations are to be performed on the data set. 


One use of the DUMMY parameter is in testing a program. When testing is finished and you 
want input or output operations performed on the data set, replace the DD DUMMY 
statement with a DD statement that fully defines the data set. 


Another use of the DUMMY parameter is in a cataloged or in-stream procedure. Code on the 

DD DUMMY statement all the required parameters. When the procedure is called, nullify the 

effects of the DUMMY parameter by coding on the DD statement that overrides the DD J 
DUMMY statement a DSNAME parameter that matches the DSNAME parameter on the DD 

DUMMY statement. For example, procedure step PS contains the following: 


//DS1 DD DUMMY , DSNAME=A, DISP=OLD 


Nullify the DUMMY parameter by coding: 


//I3S EXEC PROC=PROC1 
//PS.DS1 DD DSNAME=A 
Syntax: 


//addname DD DUMMY[,parameter]... 


All parameters coded on a DD DUMMY statement must be syntactically correct. The 
system checks their syntax. 


Parameters on DD DUMMY Statements 


e Code the DUMMY parameter by itself or follow it with all the parameters you would 
normally code when defining a data set, except the DDNAME parameter. 


@ Code the DCB parameter, if needed. If the program does not supply all the data control 
block information, make sure that the DCB parameter supplies the missing information. 


e Code AMP=AMORG if you are using VSAM. 


e If you code either VOLUME= REF=dsname or DCB=dsname with DUMMY, the 
referenced dsname must be cataloged or passed; otherwise, the job is terminated. 


e Because no I/O is performed to the dummy data set, the system checks the UNIT, SPACE, 
and DISP parameters, if coded, for syntax, then ignores them. 
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Relationship to Other Parameters 


Do not code the following parameters with the DUMMY parameter. 


‘ DYNAM 
DATA QNAME 
DDNAME 


Relationship to Other Control Statements 


Backward References: If a later DD statement in a job refers toa DD DUMMY statement 
when requesting unit affinity (UNIT = AFF =ddname) or volume affinity 

(VOLUME = REF =*.stepname.ddname), the system assigns a dummy status to the later DD 
statement. 


Overriding a Procedure DD Statement: Coding DUMMY ona DD statement that overrides a 
DD statement in a procedure does not nullify symbolic parameters on the overridden DD 
statement. You must assign values to, or nullify, symbolic parameters on the overridden DD 
statement as described in “Symbolic Parameters” on page 5-8. 


The DSNAME parameter on the overriding DD statement must not specify NULLFILE. 


If the overriding DD statement contains a SUBSYS parameter, the system nullifies a DUMMY 
parameter on the overridden DD statement in the procedure. 


Data Sets Concatenated to Dummy Data Sets: The system treats data sets concatenated to a 
DUMMY data set as dummy data sets in that I/O operations are bypassed. However, the 
system performs disposition processing and allocates devices and storage for any concatenated 
data sets. 


Relationship to Access Methods 
Use one of the following access methods with the DUMMY parameter: 


Basic sequential access method (BSAM) 

Virtual storage access method (VSAM) 

Queued sequential access method (QSAM) 

BDAM load mode (BSAM with MACRF = WL in the data control block) 


If you use any other access method, the job is terminated. 


Examples of the DUMMY Parameter 


//OUTDD1 DD DUMMY,DSNAME=X.X.Z,UNIT=3350, 
Jf SPACE=(TRK, (10,2)) ,DISP=(,CATLG) 


DD statement OUTDD1 defines a dummy data set. The other parameters coded on the 
statement are checked for syntax but not used. 
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//IN1 DD DUMMY,DCB=(BLKSIZE=800, LRECL=400 , RECFM=FB) 


DD statement IN1 defines a dummy data set. The DCB parameter supplies data control block 
information not supplied in the program. Without it, the step might be abnormally terminated. 


//IN2 DD DUMMY ,DSNAME=ELLN , DISP=OLD, VOLUME=SER=11257,UNIT=3350 


When calling a cataloged procedure that contains DD statement IN2 in procedure step STEP4, 
you can nullify the effects of the DUMMY parameter by coding: 


//STEP4.IN2 DD DSNAME=ELLN 


//TAB DD DSNAME=APP.LEV12,DISP=OLD 


If you call a cataloged procedure that contains DD statement TAB in procedure step STEP1, : 
you can make this DD statement define a dummy data set by coding: 


//STEP1.TAB DD DUMMY 


//MSGS DD SYSOUT=A 


If you call a cataloged procedure that contains the DD statement MSGS in procedure step 
LOCK, you can make this DD statement define a dummy data set by coding: 


//LOCK.MSGS DD DUMMY >: 
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DYNAM Parameter 


Parameter Type: Positional, optional 

Purpose: Use the DYNAM parameter to increase by one the control value for dynamically 
allocated resources held for reuse. Even when DYNAM is not coded, the system normally 
holds resources in anticipation of reuse. The DYNAM parameter is supported to provide 
compatibility with older systems. 


A DD DYNAM statement is a dummy request. 


Syntax: 


//addname DD DYNAM [comments ] 


Relationship to Other Parameters 
Do not code any parameters with the DYNAM parameter. 


Do not code on a DD DYNAM statement a ddname that is meaningful to the system; for 
example, JOBLIB, SYSCHK. 


Relationship to Other Control Statements 
e Do not refer toa DD DYNAM statement in a DDNAME parameter. 
e To nullify the DYNAM parameter on a DD statement in a cataloged or in-stream 
procedure, code a SYSOUT or DSNAME parameter in the overriding DD statement. 
DSNAME=NULLFILE does not nullify a DYNAM parameter. 


e Do not code a backward reference to a DD DYNAM statement. 


e Do not code the DYNAM parameter on the first DD statement for a concatenation. 


Example of the DYNAM Parameter 


//INPUT DD DYNAM 


This DD statement increases by one the control value for dynamically allocated resources held 
for reuse. 
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| EXPDT Parameter 


| Parameter Type: Keyword, optional 


| Purpose: Use the EXPDT parameter to specify the expiration date for a new data set. On and 
| after the expiration date, the data set can be deleted or written over by another data set. 


| If the DD statement contains DISP=(NEW,DELETE) or the DISP parameter is omitted to 
| default to NEW and DELETE, the system deletes the data set when the step terminates 
| normally or abnormally, even though an expiration date is also specified. 

Do not specify EXPDT for a temporary data set. 

The EXPDT parameter achieves the same result as the RETPD parameter. 


Code the EXPDT parameter when you want to (1) specify an expiration date for the data set or 
(2) with SMS, override the expiration date defined in the data class for the data set. ; 


Note: Other than information for SMS, this information for the EXPDT parameter previously 
appeared under the LABEL EXPDT subparameter. 


Syntax: 


EXPDT= | yraad | 


yyyy/ddd 


Subparameter Definition 


EXPDT = yyddd 
EXPDT = yyyy/ddd 
Specifies an expiration date for the data set. 


yyddd 
The yy is a two-digit year number (through 99) and the ddd is a three-digit day 
number from 001 through 366. For example, code February 2, 1996 as S 
EXPDT = 96033. (For expiration dates of January 1, 2000 and later, you must use 
the form EXPDT = yyyy/ddd.) 


Note: Expiration dates of 99365 and 99366 are considered “never-scratch” dates. 
Data sets with these expiration dates are not deleted or written over. 


yyyy/ddd 
The yyyy is a four-digit year number (through 2155) and the ddd is a three-digit day 
number from 001 through 366. For example, code February 2, 1996 as 
EXPDT = 1996/033, and code February 2, 2006 as EXPDT = 2006/033. 


Note: Expiration dates of 1999/365 and 1999/366 are considered “never-scratch” 
dates. Data sets with these expiration dates are not deleted or written over. 


The years from 1900 can be specified. However, if you specify the current date or an ) 
earlier date, the data set is immediately eligible for replacement. 3 
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| Overrides 
| With SMS, EXPDT overrides the expiration date defined in the data class for the data set. 
| With SMS, both the expiration date specified on EXPDT and defined in the data class for an 


| SMS-managed data set can be limited by a maximum expiration date defined in the 
| management class for the data set. 


| Relationship to Other Parameters 


| Do not code the following DD parameters with the EXPDT parameter. 
| : DYNAM 


| DATA RETPD 
| DDNAME SYSOUT 


| Deleting a Data Set Before its Expiration Date 

| To delete a data set before the expiration date has passed, use one of the following: 

| e For data sets cataloged in a VSAM or integrated catalog facility catalog, use the DELETE 
| command, as described in Integrated Catalog Administration: Access Method Services 


| Reference or VSAM Catalog Administration: Access Method Services Reference. 


| e For data sets not cataloged in a VSAM or integrated catalog facility catalog, use the 
| IEHPROGM utility, as described in Data Administration: Utilities. 


| e For the data set control block (DSCB), use the SCRATCH macro with the OVRD 


| parameter, as described in System-Data Administration. Deletion of the DSCB makes the 
| space occupied by the data set available for reallocation. 


Examples of the EXPDT Parameter 


| //DD7 DD DSNAME=TOM1,DISP=(NEW,KEEP) , EXPDT=2006/033, 
| // UNIT=3 350 ,SPACE=(TRK, (1,1) ) , VOLUME=SER=663344 


| In the example, the data set is not eligible for being deleted or written over until February 2, 
| 2006. 


| //SMSDS2. DD DSNAME=MYDS2.PGM,DATACLAS=DCLASO2 ,DISP=(NEW,KEEP), 
| // EXPDT=1996/033 


| In the example, the expiration date of February 2, 1996, overrides the expiration date defined in 
| the data class for the data set. 
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FCB Parameter 


Parameter Type: Keyword, optional 
Purpose: Use the FCB parameter to specify: 


e The forms control buffer (FCB) image JES is to use to guide printing of this sysout data set 
by a 1403 Printer, 3211 Printer, 3203 Printer Model 5, 3800 Printing Subsystem, 4245 
Printer, 4248 Printer, or by a printer supported by systems network architecture (SNA) 
remote job entry (RJE). 


e The carriage control tape JES is to use to control printing of this sysout data set by a 1403 
Printer or by a printer supported by SNA RJE. 


e The data-protection image JES is to use to control output of this sysout data set by a 3525 
Card Punch. 


The FCB image specifies how many lines are to be printed per inch and the length of the form. 2 
JES loads the image into the printer’s forms control buffer. The FCB image is stored in 
SYS1.IMAGELIB. IBM provides three standard FCB images: 


e STD1, which specifies 6 lines per inch on an 8.5-inch-long form. (3211 and 3203-2 only) 
@e STD2, which specifies 6 lines per inch on an 11-inch-long form. (3211 and 3203-2 only) 
e STD3, which in a JES3 system specifies 8 lines per inch for a dump. (3800 only) 


References: For more information on the forms control buffer, see: 


MVS/XA System-Data Administration, J 
Programming Support for the IBM 3505 Card Reader and IBM 3525 Card Punch, or 
3800 Printing Subsystem Programmer's Guide. 


Syntax: 


FCB= |fcb-name 
(fcb-name[,ALIGN|,VERIFY] ) 


You can omit the parentheses if you code only the fcb-name. 
Code the fcb-name as STD1 or STD2 only to request the IBM-supplied images. 
Code the fcb-name as STD3 only for a high-density dump in a JES3 system. 


Subparameter Definition 


fcb-name 
Identifies the FCB image. The name is | through 4 alphanumeric or national ($, #, @) 
characters and is the last characters of a SYS1.IMAGELIB member name: 


@ FCB2xxxx member for a 3211, a 3203 model 5, or a printer supported by SNA. 


@ FCB3xxxx member for a 3800. 
@ FCB4xxxx member for a 4248. . ) 
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ALIGN 
Requests that the system ask the operator to check the alignment of the printer forms 
before the data set is printed. 


Note: 
e ALIGN is ignored for a sysout data set. 


e ALIGN is ignored for a data set printed on a 3800. The 3800 does not use the 
ALIGN subparameter. 


VERIFY 
Requests that the system ask the operator to verify that the image displayed on the 
printer is for the desired FCB image. The operator can also take this opportunity to align 
the printer forms. 


Note: VERIFY is ignored for a sysout data set. 


Defaults 
If you do not code the FCB parameter, the system checks the FCB image in the printer’s forms 
control buffer; if it is a default image, as indicated by its first byte, JES uses it. If it is nota 
default image, JES loads the FCB image that is the installation default specified at JES 
initialization. 

Overrides 


An FCB parameter on a sysout DD statement overrides an OUTPUT JCL FCB parameter. 


Relationship to Other Parameters 


Do not code the following parameters with the FCB parameter. 


56 DYNAM 
AMP KEYOFF 
DATA PROTECT 


DDNAME QNAME 


Do not code the following DCB subparameters with the FCB parameter. 


CYLOFL INTVL 
RKP 


For output to the 3525, do not code the SYSOUT parameter and the FCB parameter; the 
system ignores the FCB parameter. 


Relationship to Other Control Statements 
You can also code the FCB parameter on the following: 
e The OUTPUT JCL statement. 


@ The JES2 /*OUTPUT statement. 
e The JES3 //*“FORMAT PR statement. 
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Defining an FCB Image for a Work Station 


Requesting 


When a work station uses a peripheral data set information record (PDIR), the FCB image is 
defined in the work station. The DD statement FCB fcb-name subparameter must match the 
FCB name defined in the PDIR work station. 


When a work station does not use a PDIR, add an FCB member to SYSI].IMAGELIB. At 
setup time, JES3 translates the FCB into a set vertical format (SVF). 


a High-Density Dump 


You can request a high-density dump on the 3800 through two parameters on the DD 
statement for the dump data set or on an OUTPUT JCL statement referenced by the dump DD 
statement: 


e FCB=STD3. This parameter produces dump output at 8 lines per inch. 
e CHARS=DUMP. This parameter produces 204-character print lines. 


You can code one or both of these parameters. You can place both on the same statement or 
one on each statement. 


Examples of the FCB Parameter 


//DD1 DD UNIT=3211,FCB=(IMG1,VERIFY) 


In this example, the DD statement defines an output data set to be printed by a 3211. The 
FCB parameter requests that the data set be printed under control of the FCB2IMG1 member 
in SYS].IMAGELIB. Because VERIFY is coded, the system displays the FCB image on the 
printer before printing the data set. 


//DD2 DD SYSOUT=A,FCB=IMG2 


This sysout DD statement specifies output class A. If output class A routes output to a printer 
having the forms control buffer feature, JES loads the FCB image IMG2 into the forms control 
buffer. If the printer does not have the forms control buffer feature, the operator receives a 
message to mount the carriage control tape IMG2 on the printer. 
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//OUTDDS DD UNIT=3211,FCB=(6,ALIGN) 
In this example, the DD statement defines an output data set to be printed by a 3211. The 
FCB parameter requests that the data set be printed under control of the FCB image named 6. 


Because ALIGN is coded, the system issues a message to the operator requesting that the 
alignment of the printer forms be checked before the data set is printed. 


/ /PUNCH DD UNIT=3525,FCB=DP2 


In this example, the DD statement requests output on a 3525. Therefore, the FCB parameter 
defines the data protection image to be used for the 3525. 


//SYSUDUMP DD SYSOUT=A,FCB=STD3 


In this example, the DD statement requests that the 3800 print a dump at 8 lines per inch. 
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FLASH Parameter 


Parameter Type: Keyword, optional 

Purpose: Use the FLASH parameter to identify the forms overlay to be used in printing this 
sysout data set on a 3800 Printing Subsystem and, optionally, to specify the number of copies 
on which the forms overlay is to be printed. 


Note: FLASH applies only for a data set printed on a 3800. 


References: For information on forms overlays, see the Forms Design Reference Guide for the 
IBM 3800 Printing Subsystem. 


Syntax: 


over lay-name 
FLASH= }(overlay-name[,count] ) 
NONE 


The count subparameter is optional. If you omit it, you can omit the parentheses. However, 
if you omit it, you must not code it as a null; for example, FLASH =(ABCD,) is invalid. 


Subparameter Definition 


Defaults 


overlay-name 
Identifies the forms overlay frame that the operator is to insert into the printer before 
printing begins. The name is | through 4 alphanumeric or national ($, #, @) characters. 


count 
Specifies the number, 0 through 255, of copies that JES is to flash with the overlay, 
beginning with the first copy printed. Code a count of 0 to flash all copies. 


NONE 
Suppresses flashing for this sysout data set. 


If FLASH = NONE is on a DD statement in a job to be executed at a remote node, JES3 
sets the overlay-name to zero before sending the job to the node. 


If you do not code a FLASH parameter or an installation default was not specified at JES2 or 
JES3 initialization, forms are not flashed. 


If you specify an overlay-name without specifying a count or with a count of 0, all copies are 
flashed. That is, the default for count is 255. 
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Overrides 


A FLASH parameter on a sysout DD statement overrides an OUTPUT JCL FLASH 
parameter. 


Note: A null first subparameter is invalid in a FLASH parameter on a DD statement, but is 
permitted on an OUTPUT JCL statement. 


Relationship to Other Parameters 


Do not code the following parameters with the FLASH parameter. 


i DSID PROTECT 
AMP DSNAME QNAME 
DATA DYNAM -— SUBSYS 
DDNAME LABEL VOLUME 
DISP MSVGP 


Relationship to COPIES Parameter: If this DD statement or a referenced OUTPUT JCL 
statement also contains a COPIES parameter, JES prints with the forms overlay the number of 
copies specified in one of the following: 


@e COPIES=nnn, if the FLASH count is larger than nnn. For example, if COPIES= 10 and 
FLASH =(LTHD,12) JES prints 10 copies, all with the forms overlay. 


@ The sum of the group-values specified in the COPIES parameter, if the FLASH count is 
larger than the sum. For example, if COPIES =(,(2,3,4)) and FLASH =(LTHD,12) JES 
prints nine copies in groups, all with the forms overlay. 


e The count subparameter in the FLASH parameter, if the FLASH count is smaller than nnn 
or the sum from the COPIES parameter. For example, if COPIES=10 and 


FLASH =(LTHD,7) JES prints seven copies with the forms overlay and three copies 
without. 


Relationship to Other Control Statements 
FLASH can also be coded on the following: 
e The OUTPUT JCL statement. 


@ The JES3 //*FORMAT PR statement. 
@ The JES2 /*OUTPUT statement. 


Verification of Forms Overlay Frame 
Before printing starts, the system requests the operator to load the specified forms overlay 


frame in the printer. A frame must be loaded, but the system cannot verify that it is the correct 
frame. 
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Printing without Flashing 


To print without flashing, specify one of the following: 
e FLASH=NONE on the DD or OUTPUT JCL statement. 


@ Omit the FLASH parameter on all of the statements for the data set and on all JES 
initialization statements. 


e For a sysout data set, omit the FLASH parameter on the DD statement and specify 
FLASH =(,0) on a referenced OUTPUT JCL statement. 


Example of the FLASH Parameter 


//DD1 DD SYSOUT=A,COPIES=10,FLASH=(ABCD,5) 


In this example, JES issues a message to the operator requesting that the forms-overlay frame 
named ABCD be inserted into the printer. Then JES prints the first five copies of the data set 
with the forms-overlay and the last five copies without. 
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FREE Parameter 


Parameter Type: Keyword, optional 
Purpose: Use the FREE parameter to specify when the system is to deallocate the resources 
used for this DD statement’s data set. The resources can be devices, volumes, or exclusive use 


of a data set. 


Use FREE=CLOSE on a sysout DD statement to make JES print the sysout data set before 
the job is finished. 


Syntax: 


CLOSE 


a | 


Subparameter Definition 


Defaults 


Overrides 


END 
Requests that the system deallocate the data set at the end of the step. 


CLOSE 
Requests that the system deallocate the data set when it is closed. 


If no FREE parameter is specified, the default is END. Also, if the FREE parameter is 
incorrectly coded, the system substitutes END and issues a warning message. 


FREE=CLOSE is ignored when: 


e@ The data set is a member of a concatenated group. 
e@ The task using the data set abnormally terminates. 
e The data set is referenced by another DD statement in the same or subsequent step. 


Relationship to Other Parameters 


Do not code the following parameters with the FREE parameter. 


. DYNAM 
DATA QNAME 
DDNAME 


If the DD statement specifies FREE=END and a DISP subparameter of PASS, the data set is 
not deallocated until the end of the job or until used for a later DD statement with a 
disposition of other than PASS. 
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Do not specify FREE=CLOSE on a DD statement with a ddname of JOBCAT, JOBLIB, 
STEPCAT, or STEPLIB; CLOSE 1s ignored. 


When you specify FREE=CLOSE and the job step abnormally terminates before the data set 
is closed, the system uses the abnormal termination disposition from the DISP parameter to 
process the data set. However, when you specify FREE=CLOSE and the job step abnormally 
terminates after the data set is closed, then the system has already processed the data set using 
the normal termination disposition. 


Relationship to Other Control Statements 


If a DD statement requests unit affinity in a UNIT=AFF parameter or volume affinity in a 
VOLUME=REF parameter with an earlier DD statement, do not code FREE=CLOSE on the 
earlier statement. 


If you code FREE=CLOSE on a sysout DD statement that references an OUTPUT JCL 

statement containing a GROUPID parameter, JES2 will not group the data sets into one J 
output group. Instead, JES2 produces one copy of the sysout data set for each OUTPUT JCL 

statement that the DD statement references. 


Relationship to the CLOSE Macro Instruction 


When FREE=CLOSE is specified for a data set that is opened and closed more than once 
during a job step: 


e The data set is deallocated after it is closed if the assembler CLOSE macro instruction 
specifies DISP, REWIND, or FREE. If the data set is reopened after the system has 
deallocated it, the job step abnormally terminates, unless the data set is dynamically 
allocated in the interval. 


e The data set is not deallocated until the end of the job step if the assembler CLOSE macro 
instruction specifies LEAVE or REREAD. Then the data set can be reopened. 


Examples of the FREE Parameter 


//EA33 DD SYSOUT=D,FREE=CLOSE 

In this example, the FREE=CLOSE parameter makes JES deallocate this output class D data 
set when it is closed, rather than at the end of the job step. JES schedules the data set for 
printing. 


//EA33 DD DSNAME=SYBIL,DISP=OLD,FREE=CLOSE 


In this example, the FREE=CLOSE parameter makes JES deallocate the data set, dequeue it, 
and make it available to other jobs as soon as it is closed. 
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//STEP1 EXEC PGM=ABLE1 


//DD1 DD DSNAME=A,DISP=(,PASS) , FREE=END 
//STEP2 EXEC PGM=ABLE2 
//DD2 DD DSNAME=A,DISP=(OLD,CATLG) , FREE=END 


In this example, data set A is passed by STEP] to STEP2. FREE=END on DD statement 
DD1 1s ignored because the disposition is PASS. FREE=END on DD statement DD2 causes 
data set A to be deallocated at the end of STEP2, when it is also cataloged. 


//STEP1 EXEC PGM=BAKER1 
//DD DD DSNAME=A,DISP=(NEW,PASS) ,FREE=END 
//STEP2 EXEC PGM=BAKER2 


In this example, data set A is a new data set. Because PASS is specified, FREE=END is 
ignored and the data set remains allocated. 
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HOLD Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the HOLD parameter to tell the system to hold a sysout data set until it is 
released by the system operator. When the data set is ready for processing, notify the system 
operator to release it via a TSO NOTIFY parameter, a JES2 /*“MESSAGE statement, or a 
JES3 //*OPERATOR statement. 


A TSO user can specify HOLD = YES in order to retrieve a sysout data set and display it on a 
terminal. For JES3, only work on the hold queue can be processed by the TSO user. 


Note: HOLD is supported only for sysout data sets. If HOLD appears on a DD statement 
that does not contain a SYSOUT parameter, it is ignored. 


Syntax: 
HOLD= (YES 2 
Y 
NO 
N 


Subparameter Definition 


YES 
Requests that the system hold the sysout data set until the data set is released by the 
system operator. This subparameter can also be coded as Y. 


NO 
Requests that the system perform installation-defined processing for the sysout data set’s 
output class. This subparameter can also be coded as N. 


Defaults J 


If no HOLD parameter is specified, the default is NO. If the HOLD parameter is incorrectly 
coded, the system assumes the default of NO and issues a warning message; the job continues. 


Overrides 


HOLD = NO is overridden by the deallocation verb of dynamic allocation or the TSO FREE 
command. 
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Relationship to Other Parameters 
Code the HOLD parameter only on a DD statement with the SYSOUT parameter. 
JES3 ignores HOLD= YES when 
e DEST =(node,userid) is coded, or 


e@ the sysout data set is placed on the hold queue, for example, if SYSOUT =(,writer-name) is 
coded. 


Relationship to Other Control Statements 


Code a NOTIFY parameter on the JOB statement to ask the system to send a message to your 
TSO userid when job processing is complete. 


JES2 users can use the /*NOTIFY control statement to direct job notification messages and to 
override a JOB NOTIFY parameter. 


Example of the HOLD Parameter 


//JOBO1 JOB’ ,'HAROLD DUQUETTE' ,MSGLEVEL=1 
//STEP1 EXEC PGM=MJCOSCO 
//DD1 DD  SYSOUT=B,DEST=RMT6,HOLD=YES 


Sysout data set DD1 from JOBO1 is held on a queue until the TSO user at RMT6 asks the 
system operator to release the data set. 
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KEYLEN Parameter 


Parameter Type: Keyword, optional 
Purpose: Use the KEYLEN parameter to specify the length of the keys used in a data set. 


Code the KEYLEN parameter when you want to (1) specify a key length for the data set or (2) 
with SMS, override the key length defined in the data class of the data set. 


For an existing data set, the key length can be supplied from the data set label (or data class 
with SMS). Ifa key length is not specified or supplied, input or output requests must not 


require keys. 


KEYLEN applies to data sets with the BDAM, BPAM, BSAM, EXCP, QISAM, and TCAM 
access methods, and, with SMS, to VSAM data sets. 


Note: Other than information for SMS, this information for the KEYLEN parameter 
previously appeared under the DCB KEYLEN subparameter. 


Syntax: 


KEYLEN=bytes 


Subparameter Definition 


Overrides 


bytes 
Specifies the length, in bytes, of the keys used in the data set. 


The number of bytes 1s: 


® 0 to 255 for non-VSAM data sets. The key length must be less than or equal to the 
record length. 


® 1 to 255 for VSAM key-sequenced (RECORG=KS) data sets. A key length must be 
specified, either explicitly with the KEYLEN or LIKE parameter, or in the data class 
for the data set. The key length must be less than the record length. 


KEYLEN overrides the key length specified in the data set label, and with SMS, KEYLEN 
overrides the key length defined in the data class for the data set. 
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| Relationship to Other Parameters 


Do not code the following DD parameters with the KEYLEN parameter. 


. DCB=STACK 
DATA DCB=TRTCH 
DCB=KEYLEN DDNAME 
DCB=MODE DYNAM 
DCB=PRTSP 


Examples of the KEYLEN Parameter 


//DD4 DD DSNAME=JST, DISP=(NEW, KEEP) , UNIT=3350, 
// SPACE=(CYL, (12,2) ) ,DCB=(A.B.C) , KEYLEN=8 


DD statement DD4 defines a new data set named JST and requests that the system copy the 
DCB information from the data set label of the cataloged data set named A.B.C. If the data 
set label contains a key length specification, it is overridden by the KEYLEN coded on this DD 
statement. 


//SMSDS3 DD DSNAME=MYDS3.PGM,DATACLAS=VSAM1,DISP=(NEW,KEEP), 
ti KEYLEN=6 


In the example, where the data class VSAM1 defines a key-sequenced VSAM data set, the key 
length of 6 overrides the key length defined in the data class. 
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KEYOFF Parameter 


Parameter Type: Keyword, optional — use this parameter only with SMS 

Without SMS, use the RKP subparameter of the DCB parameter described on page 10-57. 
Purpose: Use the KEYOFF parameter to specify the key offset, the position of the first byte of 
the record key in each logical record of a new VSAM data set. The first byte of a logical 


record is position 0. 


If SMS is not installed or is not active, the system syntax checks and then ignores the KEYOFF 
parameter. 


Code the KEYOFF parameter only fora VSAM key-sequenced data set (RECORG=KS). 


Code the KEYOFF parameter when you want to (1) specify a key offset for the data set or (2) 
override the key offset defined in the data class of the data set. 


References: See MVS/Extended Architecture VSAM Administration Guide for information on 
VSAM key-sequenced data sets. 


| Syntax: 


| KEYOFF=offset-to-key 


Subparameter Definition 


offset-to-key 
Specifies the position (offset), in bytes, of the first byte of the key in each record. The 
offset is 0 to the difference between the record length (LRECL) and key length 
(KEYLEN), in the range 0 to 32760. 


| Overrides » 


| KEYOFF overrides the key offset defined in the data class for the data set. 


| Relationship to Other Parameters 


| Do not code the following DD parameters with the KEYOFF parameter. 


x DYNAM 
DATA FCB 
DCB = RESERVE UCS 
DCB=RKP 

DDNAME 
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| Example of the KEYOFF Parameter 

| //SMSDS3 DD DSNAME=MYDS3.PGM,DATACLAS=VSAM1,DISP=(NEW,KEEP), 

| // KEYOFF=2 

| In the example, the data class VSAM1 defines a key-sequenced VSAM data set. The key offset 


| of 2 overrides the key offset defined in the data class and specifies that the first byte of the key 
| is in the third position of each record. 
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LABEL Parameter 


Parameter Type: Keyword, optional 
Purpose: Use the LABEL parameter to specify for a tape or direct access data set: 


The type and contents of the label or labels for the data set. 
If a password is required to access the data set. 

If the system is to open the data set only for input or output. 
The expiration date or retention period for the data set. 


Although subparameters RETPD and EXPDT are shown in the syntax of the LABEL 
parameter, you should use the RETPD or EXPDT DD parameter to specify a retention period 
or expiration date for the data set. 


For a tape data set, this parameter can also specify the relative position of the data set on the 
volume. 


References: For details on tape labels, see Magnetic Tape Labels and File Structure 
Administration. For details on direct access labels, see Data Administration Guide. For 


information on protecting a data set with a password, see System-Data Administration. 


Syntax: 


,NOPWREAD | |, OUT | | ,EXPDT=| yyddd 
; yyyy/ddd 


tA 


LABEL= /[data-set~sequence-number] |, label ‘Roewnan| hae | Sizoe- fi ) 


label is one of the following: 


The first four subparameters are positional; the last subparameter is keyword. If you omit any positional 


subparameters but code a following positional subparameter, indicate each omitted subparameter by a 
comma. If the following subparameter is keyword (EXPDT or RETPD), commas are not needed to 
indicate omitted subparameters. For example: 


LABEL = (0001,SUL,PASSWORD, IN) 
LABEL =(,SUL,PASSWORD) 

LABEL =(,SUL,,IN,EXPDT = 97033) 

LABEL =(,,PASSWORD,EXPDT = 1997/033) 
LABEL =(,SUL,EXPDT = 1997/033) 

LABEL =(0001,,,IN) 

LABEL = (0001,EXPDT = 1997/033) 


If you specify only the data-set-sequence-number or only the retention period or only the expiration date, 
you can omit the parentheses. For example, code LABEL = data-set-sequence-number, 
LABEL = RETPD = nnnn, LABEL = EXPDT = yyddd, or LABEL = EXPDT = yyyy/ddd. 
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Alternate Syntax for RETPD and EXPDT 


RETPD and EXPDT should be specified as DD parameters rather than subparameters of the LABEL 
parameter. This allows you to specify a retention period or expiration date without the need to code 
LABEL. 

For example, code RETPD and EXPDT on the DD statement as: 


RETPD = 366 or EXPDT = 2006/033 


See the DD RETPD parameter described on page 10-145 and the DD EXPDT parameter described on page 
10-90. 


Subparameter Definition 


Data-Set-Sequence-Number 


data-set-sequence-number 
Identifies the relative position of a data set on a tape volume. The 
data-set-sequence-number is 1 through 4 decimal digits. Omit this subparameter or code 
0 or 1 to indicate the first data set on the tape volume. 


Omit this subparameter for the following: 


e Cataloged data sets. The system obtains the data-set-sequence-number from the 
catalog. 


e A DD DSNAME parameter that requests all members of a generation data group 
(GDG). The system retrieves the data-set-sequence-number from the catalog. 


e A data set passed from a preceding step. The system obtains the 
data-set-sequence-number from the passing step. 


Label 


The system does not retain label type information for cataloged data sets; if the label type is not 
coded in the LABEL parameter for a cataloged data set, the system assumes SL. 


For a data set on a direct access device, the system obtains the label type from the DD 
Statement; the label type is not obtained from any other source referred to in the DD statement. 
Only two label types are valid for direct access devices: SL and SUL. 


SL 
Indicates that a data set has IBM standard labels. If this subparameter is omitted, SL is 
the default. 


Code only SL or SUL for data sets on direct access devices. 


If the LABEL parameter is coded on a SYSCKEOV DD statement, code LABEL =(,SL). 


Chapter 10. DD Statement 10-109 


DD: LABEL 


SUL 
Indicates that a data set has both IBM standard and user labels. 


Code only SL or SUL for data sets on direct access devices. 
Do not code SUL for partitioned or indexed sequential data sets. 


AL 
Indicates that a tape data set has ISO/ANSI Version 1 or ISO/ANSI/FIPS Version 3 
labels. 


If you specify AL for a tape generation data set for output, the ending .GnnnnVnn (where 
n=0 through 9) will not appear as part of the file identifier (data set name field) of the 
HDRI1 label. Instead, the data is placed in the generation and version number fields of 
the HDR1 label. 


AUL 
Indicates that a tape data set has user labels and ISO/ANSI Version 1 or ISO/ANSI/FIPS 
Version 3 labels. 


NSL 
Indicates that a tape data set has nonstandard labels. 

NL 
Indicates that a tape data set has no labels. 
When retrieving two or more data sets from several NL or BLP tape volumes, 
concatenate the DD statements and repeat the LABEL parameter on each DD statement. J 
If you are processing ASCII data on unlabeled tapes, the data control block must specify 
OPTCD =Q. 

BLP 


Requests that the system bypass label processing for a tape data set. 


If the installation did not specify the BLP feature in the reader cataloged procedure, BLP 
has the same effect as NL. } 


If you code BLP and the tape volume has labels, a tapemark delimits the data set. To let 
the system position a tape with labels to the proper data set, code the 
data-set-sequence-number subparameter; the number must reflect all labels and data sets 
that precede the desired data set. 


Do not specify BLP when the DD DSNAME parameter requests all members of a 
generation data group (GDG); the system obtains the data-set-sequence-number from the 
catalog. Therefore, coding BLP might result in incorrect tape positioning. 


When retrieving two or more data sets from several NL or BLP tape volumes, 
concatenate the DD statements and repeat the LABEL parameter on each DD statement. 


LTM 
Indicates that the data set has a leading tapemark. 
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Password Protection 


For an SMS-managed data set (one with an assigned storage class), SMS sets the password 
indicators in the VTOC and catalog but ignores the indicators and does not use password 
protection for the data set. See the DD SECMODEL parameter described on page 10-147. 


Password protecting data sets requires the following: 


@ Data set names no longer than 17 characters. MVS retains in the tape label only the 
rightmost 17 characters of the data set name. Consequently, longer names could be 
identical in password checks. 


e Volumes with IBM standard labels or ISO/ANSI/FIPS Version 3 labels. 


e A password assigned in the PASSWORD data set. If a password is not assigned, the 
system will abnormally terminate a job step when it attempts to open the data set for 
output, if NOPWREAD is coded, or for input or output, if PASSWORD is coded. 


To create a password-protected data set following an existing password-protected data set, code 
the password of the existing data set. The password must be the same in both the existing and 
the new data set. 


To password-protect a data set on a tape volume containing other data sets, you must 
password-protect all the data sets on the volume and the passwords must be the same for all 
data sets. 


To password-protect an existing data set using PASSWORD or NOPWREAD, open the data 
set for output the first time it is used during the job step. 


PASSWORD 
Indicates that a data set cannot be read, changed, deleted, or written to unless the system 
operator or TSO user supplies the correct password. 


NOPWREAD 
Indicates that a data set cannot be changed, deleted, or written to unless the system 
operator or TSO user supplies the correct password. No password is necessary for 
reading the data set. 


Input or Output Processing 


IN 
Indicates that a BSAM data set opened for INOUT or a BDAM data set opened for 
UPDAT is to be read only. The IN subparameter overrides the processing option in the 
assembler OPEN macro instruction. Any attempt by the processing program to write in 
the data set makes the system give control to the error analysis (SYNAD) routine. 

OUT 


Indicates that a BSAM data set opened for OUTIN or OUTINX is to be written in only. 
The OUT subparameter overrides the processing option in the assembler OPEN macro 
instruction. Any attempt by the processing program to read the data set makes the 
system give control to the error analysis (SSYNAD) routine. 
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Retention Period or Expiration Date for Data Set 


You should avoid using the RETPD and EXPDT subparameters on the LABEL parameter to 
specify a retention period or expiration date for the data set. 


Use the DD RETPD parameter (described on page 10-145) or the DD EXPDT parameter 


(described on page 10-90), which do the same function. This allows you to specify a retention 
period or expiration date without the need to code the LABEL parameter. 


Defaults 
e If no data-set-sequence-number subparameter is specified or if the number is coded as 0 or 
1, the default is the first data set on the tape volume, unless the data set is passed or 


cataloged. 


e If no label type subparameter is specified, the default is only IBM standard labels (SL). 


Relationship to Other Parameters 


Do not code the following parameters with the LABEL parameter. 


* DATA MODIFY 
BURST DDNAME QNAME 
CHARS DYNAM SYSOUT 
COPIES FLASH 


Do not specify the LABEL parameter with the FUNC subparameter of the DCB parameter. 
The results are unpredictable. 


ISO/ANSI/FIPS Version 3 tape data sets can be protected by use of the ACCODE parameter. 


If you specify a LABEL parameter on a SYSCKEOV DD statement, code LABEL =(,SL). 


Relationship to Other Control Statements 


When a VOLUME=REF subparameter refers to an earlier DD statement to use the same 
volume(s): 


e For tape, the system copies the LABEL label type subparameter from the referenced DD 
statement; the copied label type overrides the label type on the referencing DD statement. 


e For direct access, the system uses a LABEL=(,SL) or LABEL =(,SUL) subparameter from 
the referencing DD statement. If the referencing DD statement specifies any other label 
type, the system copies the LABEL label type subparameter from the referenced DD 
statement; the copied label type overrides the label type on the referencing DD statement. 
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Translation 
If the installation specified ASCII =INCLUDE during system generation, then AL or AUL in 
the LABEL parameter requests translation. You can also request translation by specifying 


OPTCD = Q in the data control block. If the tape is not labeled, LABEL=(,NL), you must 
specify OPTCD = Q for translation to occur. 


Examples of the LABEL Parameter 
//DD1 DD DSNAME=HERBI,DISP=(NEW,KEEP) , UNIT=TAPE, 
// VOLUME=SER=T2 , LABEL=(3,NSL,RETPD=188) 
DD statement DD1 defines a new data set. The LABEL parameter tells the system: 
@ This data set is to be the third data set on the tape volume. 
@ This tape volume has nonstandard labels. 
@ This data set is to be kept for 188 days. 


Although LABEL = (3,NSL,RETPD = 188) is valid, it is better practice to use the DD RETPD 
parameter as follows: 


//DD1 DD DSNAME=HERBI ,DISP=(NEW,KEEP) , UNIT=TAPE, 

// VOLUME=SER=T2 , LABEL=(3,NSL) ,RETPD=188 

//DD2 DD DSNAME=A.B.C,DISP=(,CATLG,DELETE) , UNIT=3400-5,LABEL=(,NL) 
DD statement DD2 defines a new data set, requests that the system catalog it, and indicates 


that the data set has no labels. Each time this data set is used by a program, the DD statement 
must include LABEL=(,NL). 


//DD3 DD DSNAME=SPECS,UNIT=3400-5 , VOLUME=SER=10222, 
// DISP=OLD , LABEL=4 


DD statement DD3 indicates an existing data set. The LABEL parameter indicates that the 
data set is fourth on the tape volume. 
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//STEP1 EXEC PGM=FIV 

/ /DDX DD DSNAME=CLEAR,DISP=(OLD,PASS) ,UNIT=3400-5, 
// VOLUME=SER=1257, LABEL=(,NSL) 

//STEP2 EXEC PGM=BOS 

/ /DDY DD DSNAME=*.STEP1.DDX,DISP=OLD,LABEL=(,NSL) 


DD statement DDX in STEP! indicates an existing data set with nonstandard labels and 
requests that the system pass the data set. DD statement DDY in STEP2 receives the data set. 
DDY contains the label type, because the system does not obtain the label type through the 
backward reference in the DSNAME parameter. 


//DDZ DD DSNAME=CATDS,DISP=OLD,LABEL=(,SUL) 


DD statement DDZ indicates an existing, cataloged data set on direct access. The data set has 
IBM standard labels and user labels. The LABEL parameter is required; otherwise, if the DD 
statement does not contain a LABEL parameter, the system assumes that a direct access data 
set has SL labels. 


//DD7 DD DSNAME=TOM1,DISP=(NEW,KEEP) , LABEL=EXPDT=2006/033, 
// UNIT=3350, SPACE=(TRK, (1,1) ) , VOLUME=SER=663344 


DD statement DD7 defines a new data set, requests the system to keep the data set, and 
indicates that the data set cannot be deleted or written over until the expiration date of 
February 2, 2006. 


Although LABEL = EXPDT = 2006/033 is valid, it is better practice to use the DD EXPDT 
parameter as follows: 


//DD7 DD DSNAME=TOM1,DISP=(NEW,KEEP) ,EXPDT=2006/033, 
7) UNIT=3350,SPACE=(TRK, (1,1) ) , VOLUME=SER=663344 
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| LIKE Parameter 


| Parameter Type: Keyword, optional — use this parameter only with SMS 
| Without SMS, use the DCB=dsname form of the DCB parameter described on page 10-45. 


| Purpose: Use the LIKE parameter to specify the allocation attributes of a new data set by 
| copying the attributes of a model data set, which must be an existing cataloged data set. 


| The following attributes are copied from the model data set to the new data set: 


e Data set organization 

— Record organization (RECORG) or 
— Record format (RECFM) 

Record length (LRECL) 

Key length (KEYLEN) 

Key offset (KEYOFF) 

Space allocation (AVGREC and SPACE) 


| If SMS is not installed or is not active, the system syntax checks and then ignores the LIKE 
| parameter. 


| The retention period (RETPD) or expiration date (EXPDT) is not copied to the new data set. 

| Note: Do not use the LIKE parameter to copy attnbutes from a temporary data set 

| (&&dsname), partitioned data set if a member name is included, and relative generation number 
| fora GDG. 


| Syntax: 


| LIKE=data-set-name 


| Subparameter Definition 


| data-set-name 
| Specifies the data set name (dsname) of the model data set whose attributes are to be used 
| as the attributes of the new data set. 


| Overrides 


| Any attributes you specify on the same DD statement with the following parameters override 
| the corresponding attributes obtained from the model data set. 


| RECORG (record organization) or RECFM (record format) 

| LRECL (record length) 

| KEYLEN (key length) 

| KEYOFF (key offset) 

| AVGREC (record request and space quantity) 

| SPACE (average record length, primary, secondary, and directory quantity) 
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Relationship to Other Parameters 


Do not code the following DD parameters with the LIKE parameter. 


DYNAM 
REFDD 
SYSOUT 


Examples of the LIKE Parameter 


//SMSDS6 DD DSNAME=MYDS6.PGM,LIKE=MYDSCAT.PGM,DISP=(NEW, KEEP) 


In the example, the data set attributes used for MYDS6.PGM are obtained from the cataloged 
model data set MYDSCAT.PGM. 


//SMSDS7 DD DSNAME=MYDS7.PGM, LIKE=MYDSCAT.PGM,DISP=(NEW,KEEP) , 
Zi LRECL=1024 


In the example, the data set attributes used for MYDS7.PGM are obtained from the cataloged 
model data sett MYDSCAT.PGM. Also, the logical record length of 1024 overrides the logical 
record length obtained from the model data set. 
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LRECL Parameter 


Parameter Type: Keyword, optional 
Purpose: Use the LRECL parameter to specify the length of the records in a data set. 


Code the LRECL parameter when you want to (1) specify the logical record length for the data 
set or (2) with SMS, override the record length defined in the data class of the data set. 


LRECL applies to data sets with the BPAM, BSAM, EXCP, QISAM, QSAM, and TCAM 
access methods, and with SMS, to VSAM data sets. 


Note: Other than information for SMS, this information for the LRECL parameter previously 
appeared under the DCB LRECL subparameter. 


Syntax: 


LRECL=bytes 


Subparameter Definition 


bytes 
Specifies (1) the length, in bytes, for fixed length records or (2) the maximum length, in 
bytes, for variable-length records. 


The value of bytes ts: 
e 1 to 32760 for non-VSAM data sets. 


e 1 to 32761 for VSAM key-sequenced (KS), entry-sequenced (ES), or relative record 
(RR) data sets. (LRECL does not apply to VSAM linear space, RECORG = LS, data 
sets.) 


For VSAM key-sequenced (KS) data sets, a record length must be specified, either 
explicitly with the LRECL or LIKE parameter, or in the data class for the data set. 
The record length must be greater than the key length. 


Note: When RECFM is F or U, the length must not exceed DCB BLKSIZE. For 
RECFM =D or V, the length must not exceed BLKSIZE minus 4. For RECFM=VS, 
the length can exceed BLKSIZE. For unblocked records when DCB RKP =(, the length 
is for only the data portion of the record. 


Additional Syntax for LRECL = bytes 


LRECL = nnnonK 
Specifies the length in kilobytes for variable-length spanned records in ISO/ANSI/FIPS 
Version 3 tape data sets that are processed by the Data Facility Product using the 
extended logical record interface (XLRI). nnnnn is from 1 through 16383 and indicates 
multiples of 1024 bytes. The value in the DCB must be LRECL=OK or 
LRECL=nnnnnk. If a K is coded for any other type of data set, only the numeric value 
of LRECL is recognized. 
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LRECL=X 
For QSAM only, specifies that the logical record length exceeds 32760 bytes for 
variable-length spanned records. This option is not valid for ISO/ANSI/FIPS Version 3 
variable-length records. 


Overrides 


LRECL overrides the record length specified in the data set label, and with SMS, LRECL 
overrides the record length defined in the data class for the data set. 


Relationship to Other Parameters 


Do not code the following DD parameters with the LRECL parameter. 


DCB=LRECL 
DDNAME 
DYNAM 


Examples of the LRECL Parameter 


//DD1B DD DSNAME=EVER,DISP=(NEW,KEEP) , UNIT=3380, 
Ve, RECFM=FB , LRECL=326 , SPACE=(23472, (200,40) ) 


In the example, the logical record length of 326 is used for the new data set EVER. 


//SMSDS2. DD NAME=MYDS2.PGM,DATACLAS=DCLASO2 ,DISP=(NEW,KEEP), 
va) LRECL=256 


In the example, the logical record length of 256 overrides the logical record length defined in 
the data class for the data set. 
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| MGMTCLAS Parameter 


| Parameter Type: Keyword, optional — use this parameter only with SMS and for 
| SMS-managed data sets 


| Without SMS, there are no DD parameters that provide this function. 

| Purpose: Use the MGMTCLAS parameter to specify a management class for a new 

| SMS-managed data set. The storage administrator at your installation defines the names of the 
| management classes you can code on the MGMTCLAS parameter. 


After the data set is allocated, attributes in the management class control: 


@ The migration of the data set, which includes migration from primary storage to 
DFHSM-owned storage to archival storage. 


@ The backup of the data set, which includes frequency of backup, number of versions, and 
retention criteria for backup versions. 


The Hierarchical Storage Manager (DFHSM) or a functionally equivalent program performs 
| these functions. 


| If SMS is not installed or is not active, the system syntax checks and then ignores the 
| MGMTCLAS parameter. 


| SMS ignores the MGMTCLAS parameter if you specify it for an existing data set. 
| The use of a management class can be protected by RACF. 


| References: See MVS/XA Interactive Storage Management Facility User’s Guide for 
| information on how to use ISMF to view your installation-defined management classes. 


| Syntax: 


| MGMTCLAS=management-class-name 


| Subparameter Definition 
| management-class-name 
| Specifies the name of a management class to be used for management of the 


| SMS-managed data set after the data set is allocated. 


| The name, one to eight characters, is defined by the storage administrator at your 
| installation. 
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Defaults 


Overrides 


If you do not specify MGMTCLAS for a new data set and the storage administrator has 
provided an installation-written automatic class selection (ACS) routine, the ACS routine may 
select a management class for the data set. Check with your storage administrator to determine 
if an ACS routine will select a management class for the new data set, in which case you do not 
need to specify MGMTCLAS. 


You cannot override management class attributes via JCL parameters. 


The management class for a data set defines a maximum value for the expiration date or 
retention period of the data set. This maximum limits the values that are specified on the 
EXPDT or RETPD parameter, or defined in the data class for the data set. 


An ACS routine can override the management class that you specify on the MGMTCLAS 
parameter. 


Relationship to Other Parameters 


Do not code the following DD parameters with the MGMTCLAS parameter. 


. DYNAM 
DATA QNAME 
DDNAME 


Code MGMTCLAS only when you specify a storage class for the data set (via the STORCLAS 
parameter) or an ACS routine selects a storage class. 


Example of the MGMTCLAS Parameter 


//SMSDS1 DD DSNAME=MYDS1.PGM,DATACLAS=DCLAS1,STORCLAS=SCLAS1, 
// MGMTCLAS=MCLASO1 ,DISP=(NEW, KEEP) 


In the example, SMS uses the attributes in the management class named MCLASO1 to handle 
the migration and backup of the SMS-managed data set. Note that installation-written ACS 
routines may override the specified management class, storage class, and data class. 
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MODIFY Parameter 


Parameter Type: Keyword, optional 

Purpose: Use the MODIFY parameter to specify a copy-modification module that tells JES 
how to print this sysout data set on a 3800 Printing Subsystem. The module can specify the 
following: 

e Legends. 

e Column headings. 

@ Where and on which copies the data is to be printed. 


The module is defined and stored in SYS1..MAGELIB using the IEBIMAGE utility program. 


Note: MODIFY applies only for the 3800 Printing Subsystem Model | and 2 and the 3800 
Printing Subsystem Model 3, 6, and 8 in compatibility mode. 


References: For more information on the copy modification module and the IEBIMAGE 
utility program, see Data Administration: Utilities. 


Syntax: 


MODIFY= |module-name 
(module-name[,trc]) 


You must code the module-name. 


The tre subparameter is optional. If you omit it, you can omit the parentheses. 
However, if you omit it, you must not code it as a null; for example, 
MODIFY =(TABI1,) is invalid. 


Subparameter Definition. 


module-name 
Identifies a copy-modification module in SYS1.IMAGELIB. The module-name is 1 
through 4 alphanumeric or national ($, #, @) characters. 


tre 
Identifies which table-name in the CHARS parameter is to be used. This table reference 
character is 0 for the first table-name specified, 1 for the second, 2 for the third, or 3 for 
the fourth. The CHARS parameter is on the following, in override order: 
1. This DD statement. 
2. A referenced OUTPUT JCL statement. 


3. A statement in the library member specified on the OUTPUT JCL PAGEDEF 
parameter. 


4. A statement in the SYS1.IMAGELIB member obtained by default. 


5. A JES3 initialization statement. 
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Defaults 


Overrides 


If no MODIFY parameter is specified, JES3 uses an installation default specified at 
initialization. JES2 provides no installation default at initialization. 


If you do not specify tre or if the tre value is greater than the number of table-names in the 
CHARS parameter, JES2 uses the first table named in the CHARS parameter and JES3 uses 
the default character arrangement table. 


A MODIFY parameter on a sysout DD statement overrides an OUTPUT JCL MODIFY 
parameter. 


Note: A null first subparameter is invalid in a MODIFY parameter on a DD statement, but is 
permitted on an OUTPUT JCL statement. 


Relationship to Other Parameters 


Do not code the following parameters with the MODIFY parameter. 


. DSID PROTECT 
AMP DSNAME QNAME 
DATA DYNAM SUBSYS 
DDNAME LABEL VOLUME 
DISP MSVGP 


Relationship to Other Control Statements 


MODIFY can also be coded on the following: 


e The OUTPUT JCL statement. 
e The JES3 //*FORMAT PR statement. 
@ The JES2 /*OUTPUT statement. 


The second character of each logical record can be a TRC code, so that each record can be 
printed in a different font. This way of specifying fonts is indicated by the OUTPUT JCL TRC 
parameter. 


Example of the MODIFY Parameter 


//DD1 DD UNIT=3800,MODIFY=(A,0) ,CHARS=(GS15,GS10) 


In this example, the MODIFY parameter requests that the data in the copy-modification 
module named A replace variable data in the data set to be printed by the 3800. Module A 
defines which positions are to be replaced and which copies are to be modified. The second 
subparameter in MODIFY specifies that the first character arrangement table in the CHARS 
parameter, GS15, be used. 
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MSVGP Parameter 


Parameter Type: Keyword, optional 

Note that SMS does not manage mass storage volumes for SMS-managed data sets. 

Purpose: Use the MSVGP parameter to place the data set in a group of mass storage volumes 
on a mass storage system (MSS) device. MSVGP applies only to a nonspecific volume request, 


which is a DD statement for a new data set that can be assigned to any volume or volumes. 


References: For information on defining mass storage groups, see Mass Storage System 
(MSS) Services General Information. 


Syntax: 


SYSGROUP 


You can omit the parentheses if you code only the id subparameter or SYSGROUP. 


Subparameter Definition 


id 
MSVGP=}j(id[,ddname] ) 


id 
Identifies a group of mass storage volumes. The id is 1 through 8 alphanumeric or 
national ($, #, @) characters and must be previously defined by the installation using a 
mass storage system service. 


ddname 
Requests that the data set for this DD statement is to be allocated to volume(s) other 
than the volume(s) occupied by the data set for DD statement ddname. DD statement 
ddname must appear earlier in the job step. 


If volume separation within the group is not possible, the system terminates the job. 
The ddname refers to only the first data set (1) when the named DD statement starts a 
concatenation or (2) when the DSNAME parameter of the named DD statement requests 
all members of a generation data group (GDG). 

SYSGROUP 


Identifies a default group of mass storage volumes. Code MVSGP=SYSGROUP to 
make sure that a nonspecific request is allocated to SYSGROUP. 
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Relationship to Other Parameters 


Do not code the following parameters with the MSVGP parameter. J 
* DDNAME QNAME 
BURST DSID SYSOUT 
CHARS DYNAM 
COPIES FLASH 
DATA MODIFY 


SPACE Parameter: Code the SPACE parameter for the following reasons: 


@ To allocate noncontiguous primary space. Contiguous space is the MSVGP default. 
e For nonspecific requests for BPAM and ISAM data sets. 


Do not code the ABSTR, MXIG, and ALX subparameters in the SPACE parameter. 
VOLUME Parameter: Do not code VOLUME=SER with the MSVGP parameter; 


VOLUME =SER is a specific volume request, while MSVGP can be used only for nonspecific 
volume requests. 


VOLUME= PRIVATE with MSVGP is redundant, because MSVGP causes allocation to a 
private volume. 


UNIT and VOLUME Counts: The unit count in the UNIT parameter must be less than the 
volume count in the VOLUME parameter to guarantee allocation of a unit that is not shared 
with another job. 


Allocation when MSVGP is Not Coded 


When a DD statement defines a new, nonspecific data set to be placed on an MSS device and 
does not contain an MSVGP parameter, the system allocates as follows: 


e Places a permanent data set on a mounted 3330V Disk Storage volume, if one exists. If 
one does not exist, a volume is selected from SYSGROUP; in this case, the DD statement 
must contain a SPACE parameter or the job is terminated. 


e Places a temporary data set on a mounted 3330V Disk Storage public volume, if one exists. J 
If one does not exist or it does not have enough space, a volume is selected from 
SYSGROUP. 
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Examples of the MSVGP Parameter 


//DD1 DD DSNAME=ACCOUNT, DISP=(NEW,CATLG) , UNIT=3330V, 
Va MSVGP=AB$1234@,VOLUME=(,,,3) 


A new, cataloged data set is to be created on one, two, or three mass storage volumes in the 
group called AB$1234@. The installation previously defined this group and assigned at least 
three volumes to it. If the installation provided a space default of SPACE =(CYL,(200,100)), 
the system selects from the group a volume with at least 200 cylinders available. 


During step execution, if more than 200 cylinders are required, and if 100 more cylinders are 
not available on the mounted volume, the system asks the operator to demount the volume. 
The system selects from group AB$1234@ a volume with at least 100 cylinders available and 
asks the operator to mount the volume. The volume count of three allows the data set to 
extend over three volumes. If more are required, the step abnormally terminates. 


//DD1 DD DSNAME=MASTRIN,DISP=OLD 
//DD2 DD DSNAME=MASTROUT, UNIT=3330V,DISP=(,CATLG), 
// MSVGP=(ABS1234@,DD1) 


DD1 requests an existing cataloged data set. DD2 defines a new data set that will be allocated 
to a volume in mass storage group AB$1234@. 


Because DD1 is specified as the ddname subparameter of MSVGP on DD2, the system 


allocates the DD2 data set, MASTROUT, to different volumes than the volumes for the DD1 
data set, MASTRIN. 
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OUTLIM Parameter 


Parameter Type: Keyword, optional 

Purpose: Use the OUTLIM parameter to limit the number of logical records in the sysout data 
set defined by this DD statement. When the limit is reached, the system exits to the SYSOUT 
limit exit routine. If the installation supplies a user-written routine, the routine can determine 
whether to terminate the job or increase the limit. If the installation does not supply a routine, 
the system terminates the job. 

If the installation supplies a routine, it must be in the SYS1.LPALIB library. 

Note: OUTLIM is valid only on a DD statement with a SYSOUT parameter. 


References: For more information on the SYSOUT limit exit routine, see SPL: System 
Management Facilities. 


Syntax: 


OUTLIM=number 


Subparameter Definition 


Default 


number 
Specifies the maximum number of logical records. The number is | through 8 decimal 
digits from 1 through 16777215. 


(1) If no OUTLIM parameter is specified or OUTLIM =0 is coded and (2) if output is not 
limited by JES control statements, JES3 uses an installation default specified at initialization; 
JES2 provides no installation default at initialization. 


Relationship to Other Parameters 


Code the OUTLIM parameter only on a DD statement with the SYSOUT parameter. 


Do not code the OUTLIM parameter with the DCB subparameters CPRI or THRESH; these 
subparameters can alter the OUTLIM value. 


On Dump DD Statements: JES3 ignores an OUTLIM parameter on a SYSABEND or 
SYSUDUMP DD statement. 
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Relationship to Other Control Statements 
Output can also be limited by the following: 


e The LINES, BYTES, PAGES, or CARDS parameter of the JES2 /*JOBPARM statement. 
e The LINES, BYTES, PAGES, or CARDS parameter of the JES3 //*MAIN statement. 


Example of the OUTLIM Parameter 


//OUTDD DD SYSOUT=F ,OUTLIM=1000 


The limit for the number of logical records is 1000. 
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OUTPUT Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the OUTPUT parameter with the SYSOUT parameter to associate a sysout data 
set explicitly with an OUTPUT JCL statement. JES processes the sysout data set using the 
options from this DD statement combined with the options from the referenced OUTPUT JCL 
statement. 


When the OUTPUT parameter references more than one OUTPUT JCL statement, the system 
produces separate output for each OUTPUT JCL statement. 


Note: Code the OUTPUT parameter only on a DD statement with a SYSOUT parameter. 
Otherwise, the system checks the OUTPUT parameter for syntax then ignores it. 


Syntax: 


OUTPUT= |reference J 


(reference[,reference]...) 
A reference is one of the following: 
* .name 


*,stepname.name 
*,stepname.procstepname.name 


You can omit the parentheses if you code only one reference. J 


You must not code a null in an OUTPUT parameter. For example, 
OUTPUT =(,*.name) is invalid. 


You can reference a maximum of 128 OUTPUT JCL statements on one OUTPUT 
parameter. 


You can code references in any combination. For example, the following are valid: 


//EXA DD SYSOUT=A , OUTPUT=(*.name,*.name,*.stepname.name) J 
//EXB DD SYSOUT=A,OUTPUT=(*.stepname.name, 
// *,stepname.procstepname.name,*.name) 


You can code the references to OUTPUT JCL statements in any order. 
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Subparameter Definition 


* name 
Refers to an earlier OUTPUT JCL statement with name in its name field. The system 
searches for the OUTPUT JCL statement first in the same step, then before the first 
EXEC statement of the job. 


* stepname.name 
Refers to an earlier OUTPUT JCL statement, name, in this step or an earlier step, 
stepname, in the same job. 


* stepname.procstepname.name 
Refers to an OUTPUT JCL statement in a cataloged or in-stream procedure. Stepname 
is the name of this job step or an earlier job step that calls the procedure, procstepname is 
the name of the procedure step that contains the OUTPUT JCL statement, and name is 
the name field of the OUTPUT JCL statement. 


Defaults 
If you do not code an OUTPUT parameter on a sysout DD statement, JES obtains processing 
options for the sysout data set in the following order: 
1. From each OUTPUT JCL statement containing DEFAULT = YES in the same step. 
2. From each OUTPUT JCL statement containing DEFAULT = YES before the first EXEC 
statement in the job, provided that the step contains no OUTPUT JCL statements with 
DEFAULT = YES. 
3. Only from the sysout DD statement, provided that neither the step nor job contains any 
OUTPUT JCL statements with DEFAULT = YES. 
Overrides 


When an OUTPUT JCL statement is used with the sysout DD statement to specify processing, 
JES handles parameters as follows: 


e Ifa parameter appears on the DD statement, JES uses the parameter. 
e Ifa parameter appears only on the OUTPUT JCL statement, JES uses the parameter. 
e Ifthe same parameter appears on both statements, JES uses the DD parameter. 


JES uses the whole overriding parameter, ignoring the whole overridden parameter. If a 
subparameter is left off the overriding parameter, the system does not pick up that 
subparameter from the overridden parameter. For example: 


//EXAMP2 OUTPUT  FLASH=(ABCD,3) 
/ /ENZ2 DD SYSOUT=F , OUTPUT=* . EXAMP2 , FLASH= (EFGH) 


Only EFGH is used. The system ignores all of the FLASH parameter on the OUTPUT JCL 
statement, including the second parameter. 
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Relationship to Other Parameters 
Code the OUTPUT parameter only on a DD statement with the SYSOUT parameter. J 


With INTRDR Subparameter in SYSOUT Parameter: Do not code an OUTPUT parameter 
when the SYSOUT parameter specifies a JES2 internal reader by an INTRDR parameter. 


Null Subparameters: A null first subparameter is invalid ina FLASH or MODIFY parameter 
on a DD statement, but is permitted on an OUTPUT JCL statement. For example, 
MODIFY =(,3) is valid only on an OUTPUT JCL statement. 


SYSOUT Third Subparameter: You cannot reference a JES2 /*“OUTPUT statement using the 
third subparameter of the SYSOUT parameter if either of the following is also coded: 


e The OUTPUT parameter on the same DD statement. 


e An OUTPUT JCL statement containing DEFAULT = YES 1n the same step or before the 
EXEC statement of the job, when the DD statement does not contain an OUTPUT J 
parameter. 


DEFAULT Parameter on OUTPUT JCL Statement: If you code DEFAULT=YES on an 
OUTPUT JCL statement, you can still refer to that OUTPUT JCL statement in the OUTPUT 
parameter of a sysout DD statement. 


Location in the JCL 


All referenced OUTPUT JCL statements must precede the DD statement that refers to them. 
If the referencing DD statement appears in an in-stream or cataloged procedure, the referenced 
OUTPUT JCL statement must precede the DD statement in the procedure. A sysout DD 
statement in a procedure cannot refer to an OUTPUT JCL statement in the calling step. 


No Match for OUTPUT Name 


If the system finds no match for the name coded in the OUTPUT parameter, the system issues 
a JCL error message and fails the job. ) 


Processing Options in Multiple References 


A sysout DD statement can refer to more than one OUTPUT JCL statement, either explicitly 
in an OUTPUT parameter containing more than one reference or implicitly when several 
default OUTPUT JCL statements apply. The processing options for a sysout data set come 
from one sysout DD statement and one OUTPUT JCL statement. In multiple references, each 
combination of sysout DD statement and one of the referenced OUTPUT JCL statements 
produces a separate set of printed or punched output. 


Processing options are not cumulative across a group of OUTPUT JCL statements. 


10-130 MVS/XA JCL Reference 


DD: OUTPUT 


Examples of the OUTPUT Parameter 


//d1 JOB , ‘MARY LUDWIG! 

//JOUT OUTPUT CLASS=C,FORMS=RECP , INDEX=6 

//STEP1 EXEC PGM=XYZ 

//SOUT OUTPUT CLASS=H,BURST=YES ,CHARS=GT12 ,FLASH=BLHD 


//ALL DD SYSOUT=(,) ,OUTPUT=(*.JOUT,*.SOUT) , COPIES=5 
//IN DD * 

(data) 
/* ) 


The OUTPUT parameter references two OUTPUT JCL statements. Therefore, the system 
prints the single sysout data set twice: 


e For DD ALL combined with OUTPUT JOUT, the sysout data set is printed in class C. In 
the installation, output class C is printed on a 3211 Printer. Combining the parameters 
from the DD and OUTPUT JCL statements, the system prints 5 copies of the data set on 
form RECP and indents the left margin 5 spaces. 


e For DD ALL combined with OUTPUT SOUT, the sysout data set is printed in class H. In 
the installation, output class H is printed on a 3800 Printing Subsystem. Combining the 
parameters from the DD and OUTPUT JCL statements, the system prints 5 copies of the 
data set with the forms-overlay frame named BLHD using character-arrangement table 
GT12 and bursts the output. 


//I36 JOB ,'SUE THACKER' 

//OUTA OUTPUT DEST=HQ 

//STEP1 EXEC PGM=RDR 

//OUTB OUTPUT CONTROL=DOUBLE 

//DS1 DD SYSOUT=A , OUTPUT=(*.OUTA, *.OUTB) 
//STEP2 EXEC PGM=WRT 

//OUTC OUTPUT DEST=ID2742 

//DS2 DD SYSOUT=A, OUTPUT=(*.OUTC,*.STEP1.OUTB) 


The OUTPUT parameter on DS1 references: 
@ The job-level OUTPUT JCL statement OUTA to send the sysout data set to HQ. 


@ The step-level OUTPUT JCL statement OUTB to print the sysout data set double-spaced 
on the local 3800 Printing Subsystem used for output class A. 


The OUTPUT parameter on DS2 references: 


e OUTPUT JCL statement OUTB in the first step to print the sysout data set double-spaced 
on the local 3800 Printing Subsystem used for output class A. 


® OUTPUT JCL statement OUTC in the same step to send the sysout data set to userid 
ID2742, which is attached to the local system. 


Note that the references to OUTPUT JCL statements are in no particular order. 
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PROTECT Parameter 


Parameter Type: Keyword, optional 
Use the PROTECT parameter only if RACF is installed and active. 


With SMS, use the SECMODEL parameter to protect data sets; SECMODEL is described on 
page 10-147. 


Purpose: Use the PROTECT parameter to tell the Resource Access Control Facility (RACF) 
to protect: 


@ One data set on a direct access volume. 
@ One data set on a tape volume with one of the following types of labels: 


— IBM standard labels, LABEL=(,SL) or LABEL =(,SUL) 
— ISO/ANSI/FIPS Version 3 labels, LABEL =(,AL) or LABEL=(,AUL) 
— Nonstandard labels, LABEL=(,NSL), if the installation provides support 


e An entire tape volume with one of the following: 


— IBM standard labels, LABEL=(,SL) or LABEL =(,SUL) 

— ISO/ANSI/FIPS Version 3 labels, LABEL =(,AL) or LABEL=(,AUL) 

— Nonstandard labels, LABEL=(,NSL), if the installation provides support 
— No labels, LABEL =(,NL) 

— Bypassed label processing, LABEL =(,BLP) 

— Leading tapemarks, LABEL=(,LTM) 


References: For more information on RACF, see Resource Access Control Facility (RACF) 
General Information Manual. 


Syntax: 


Y 


ini ta 


Subparameter Definition 
YES 


Requests RACF to protect a direct access data set, tape data set, or tape volume. This 
parameter can also be coded as Y. 
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| Overrides 


| With SMS, the DD SECMODEL parameter overrides the PROTECT = YES parameter. 


Relationship to Other Parameters 


Do not code the following parameters with the PROTECT parameter. 


| ‘ DLM QNAME 
| BURST DYNAM  SYSOUT 
| CHARS FCB TERM 

| DATA FLASH UCS 

| 


DDNAME MODIFY 
DSNAME Parameter for RACF-Protected Data Sets: RACF expects the data set name 


specified in the DSNAME parameter to have a high-level qualifier that is defined to RACF. 
See the RACF Security Administrator's Guide for details. 


Requirements for Protecting a Tape Data Set 


| A DD statement that contains a PROTECT parameter to establish RACF protection for a tape 
data set must: 


@ Specify or imply VOLUME= PRIVATE. 


e Specify or imply DISP=NEW, DISP=OLD, or DISP=SHR; it must not specify or imply 
DISP = MOD. 


e Specify in the LABEL parameter a label type of: 
— SL or SUL for IBM standard labels. 
— AL or AUL for ISO/ANSI Version 1 or ISO/ANSI/FIPS Version 3 tape labels. 
— NSL for nonstandard labels. In this case, the NSL installation exit routine must issue a 
RACDEF or RACROUTE TYPE=DEFINE macro instruction. See SPL: System 


Macros and Facilities for a description of these macro instructions. 


e Specify in the LABEL parameter a data-set-sequence-number, if the data set is not the first 
on the volume. 


Requirements for Protecting a Tape Volume 


| A DD statement that contains a PROTECT parameter to establish RACF protection for a tape 
volume must: 


e Specify or imply VOLUME=PRIVATE. 
e Specify or imply DISP= NEW. 
@ Specify in the LABEL parameter a label type of: 


— SL or SUL for IBM standard labels. 
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— AL or AUL for ISO/ANSI Version | or ISO/ANSI/FIPS Version 3 tape labels. 


— NSL for nonstandard labels. In this case, the NSL installation exit routine must issue a 
RACDEF or RACROUTE TYPE=DEFINE macro instruction. 


— NL for no labels. 
— BLP for bypass label processing. 
— LTM for leading tapemark. 
Note that RACF cannot fully protect unlabeled tapes because RACF cannot verify the volume 


serial number directly; the operator must verify the volume serial number when mounting the 
tape volume. 


Requirements for Protecting a Direct Access Data Set 


A DD statement that contains a PROTECT parameter to establish RACF protection for a 
direct access data set must: 


e Name a permanent data set in the DSNAME parameter. 


e Specify a status of DISP=NEW or MOD treated as NEW. RACF can establish protection 
only when the data set is being created. 


Examples of the PROTECT Parameter S) 


//DASD DD DSNAME=USER37.MYDATA,DISP=(,CATLG), 
ya VOLUME=SER=3 33000, UNIT=3330,SPACE=(TRK,2) , PROTECT=YES 


This DD statement requests RACF protection for the new direct access data set 


USER37.MYDATA. 
//TAPEVOL DD DSNAME=MHB1.TAPEDS,DISP=(NEW,KEEP) ,LABEL=(,NL), 
// VOLUME=SER=T4 9850 , UNIT=3400-5, PROTECT=YES 


This DD statement requests RACF protection for tape volume T49850. Because a specific tape 
volume is requested, it automatically has the PRIVATE attribute. The volume has no labels. 


//TAPEDS DD DSNAME=INST7.NEWDS , DISP=(NEW,CATLG) ,LABEL=(2,SUL), 
// VOLUME=SER=223344 ,UNIT=3400-5 , PROTECT=YES 


This DD statement requests RACF protection for INST7.NEWDS, which is the second data set 
on tape volume 223344. Because a specific tape volume is requested, it automatically has the 
PRIVATE attribute. The volume has IBM standard and user labels; the RACF Release 1.7 
TAPEDSN facility must be active. 
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QNAME Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the QNAME parameter to indicate that this DD statement defines a data set of 
telecommunications access method (TCAM) messages. The QNAME parameter refers to a 
TPROCESS macro instruction that defines a destination queue for the messages. Optionally, 
the QNAME parameter can also name a TCAM job to process the messages. 


References: For information about TCAM and the TPROCESS macro instruction, see 
Advanced Communications Function for TCAM, Version 2, Installation Reference. 


Syntax: 


QONAME=procname[.tcamname] 


Subparameter Definition 


procname 
Identifies a TPROCESS macro instruction; procname must be identical to the procname 
in the name field of the TPROCESS macro instruction. 


tcamname 


Names a TCAM job: tcamname must be identical to the jobname. The TCAM job can 
be a task started by an operator START command. 


Relationship to Other Parameters 
The only DD parameters that you can code with the QNAME parameter are DCB, LIKE, 


LRECL, RECFM, and REFDD. The only DCB subparameters that you can code with the 
QNAME parameter are: BLKSIZE, BUFL, LRECL, OPTCD, and RECFM. 


Examples of the QNAME Parameter 


//DYD DD QNAME=FIRST,DCB=(RECFM=FB ,LRECL=80,BLKSIZE=320) 


This DD statement defines a data set of TCAM messages. FIRST is the name of the 
TPROCESS macro instruction that specifies the destination queue to which the messages are 
routed. The DCB parameter supplies information not supplied in the program’s DCB macro 
instruction for the data control block. 


//DXD DD QNAME=SECOND.TCAMO1 
This DD statement defines a data set of TCAM messages. SECOND is the name of the 


TPROCESS macro instruction that specifies the destination queue to which the messages are 
routed. TCAM program TCAMO1 will process the messages. 
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. RECEM Parameter 


| Parameter Type: Keyword, optional 


| Purpose: Use the RECFM parameter to specify the format and characteristics of the records in 
a data set. All the format and characteristics must be completely described in one source, that 
is, in the data set label of an existing data set, in the DCB macro, in the DD DCB parameter, 
or in the DD RECFM parameter. However, the processing program can modify the RECFM 
field in the DCB. 


Code the RECFM parameter when you want to (1) specify the record format for the data set or 
(2) with SMS, override the record format defined in the data class of the data set. 


The syntax of the RECFM parameter is described in the following topics: 


Coding RECFM for Data Sets with SMS 

Coding RECFM for BDAM Access Method * S 
Coding RECFM for BPAM Access Method * 

Coding RECFM for BSAM, EXCP, and QSAM Access Methods * 

Coding RECFM for QISAM Access Method * 

Coding RECFM for TCAM Access Method * 


* These descriptions previously appeared under the DCB RECFM subparameter. 


When indicated in the syntax diagrams, combinations of characteristics can be coded. For 
example, for data sets with SMS, FBS indicates that the records are fixed, blocked, and 
spanned. 


Coding RECFM for Data Sets with SMS 


Syntax: Data Sets with SMS 


A or M can be coded with any record format, such as: RECFM =FBA 


You can specify spanned (S) records only for physical sequential (PS) data sets. 


indicates that the records are blocked. 

indicates that the records are fixed length. 

indicates that the records are spanned. 

indicates that the records are variable length. 

indicates that the records are undefined length. 

indicates that the records contain ISO/ANSI control characters. 
indicates that the records contain machine code control characters. 
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| Coding RECFM for BDAM Access Method 


| Syntax: BDAM Access Method 


| indicates that the records are undefined length. 

| indicates that the records are variable length. 

| indicates that the records are spanned. 

| indicates that the records are fixed length. 

| indicates that the records may be written using the track-overflow feature. 


| Default: undefined-length, unblocked records. 


| Coding RECFM for BPAM Access Method 


| Syntax: BPAM Access Method 


A or M can be coded with any record format, such as: RECFM =FBA 


| 

| indicates that the records are blocked. 

| indicates that the records are fixed length. 

| indicates that the records may be written using the track-overflow feature. Chained scheduling (OPTCD =C) 
| will be ignored. 

| indicates that the records are undefined length. 

| indicates that the records are variable length. 

| indicates that the records contain ISO/ANSI control characters. 

| indicates that the records contain machine code control characters. 


| Default: U 
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Coding RECFM for BSAM, EXCP, and QSAM Access Methods 


Syntax: BSAM, EXCP, and QSAM Access Methods J 


For BSAM, EXCP, and QSAM using ISO/ANSI/FIPS data sets on tape: 


D 
DB 
DS 


A can be coded with any record format, such as: RECFM=FBA 


A or M cannot be specified if the PRTSP subparameter is specified. 


indicates that the records are blocked. 

indicates that the records are variable-length ISO/ANSI tape records. 

indicates that the records are fixed length. 

(1) For fixed-length records, indicates that the records are written as standard blocks, that is, no truncated 
blocks or unfilled tracks within the data set, with the exception of the last block or track. (2) For 
variable-length records, indicates that a record can span more than one block. 

indicates that the records can be written using the track-overflow feature, if required. Chained scheduling 
(OPTCD = C) is ignored. 

indicates that the records are undefined length. U is invalid for an ISO/ANSI/FIPS Version 3 tape data set. 
indicates that the records are variable length. V cannot be specified for (1) a variable-length ISO/ANSI tape 
data set (specify D for this data set), (2) a card reader data set, or (3) a 7-track tape unless the data conversion 
feature (TRTCH =C) is used. 

indicates that the record contains ISO/ANSI device control characters. 

indicates that the records contain machine code control characters. 


Default: U for IBM standard label tapes. 
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| Coding RECFM for QISAM Access Method 


| Syntax: QISAM Access Method 


| V 
| RECFM= | VB 
| F 
| FB 


| B indicates that the records are blocked. 
| F indicates that the records are fixed length. 
| V indicates that the records are variable length; variable records cannot be in ASCII. 


| When creating indexed sequential data sets, you can code the RECFM subparameter; when processing existing 
| indexed sequential data sets, you must omit RECFM. 


| Default: V 


| Coding RECFM for TCAM Access Method 


| Syntax: TCAM Access Method 


indicates that the records are blocked. 


| indicates that the records are fixed length. 
| indicates that the records are undefined length. 
| indicates that the records are variable length. 


| Default: U 


Overrides 


RECFM overrides the record format specified in the data set label, and with SMS, RECFM 
overrides the record format defined in the data class for the data set. 


| Relationship to Other Parameters 


Do not code the following DD parameters with the RECFM parameter. 
* DDNAME 
AMP DYNAM 
DATA RECORG 
DCB=DSORG 
DCB=RECFM 
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Examples of the RECFM Parameter 
//DD1B DD DSNAME=EVER , DISP=(NEW, KEEP) , UNIT=3380, 
ii RECFM=FB , LRECL=326 , SPACE=(23472, (200,40) ) 


In the example, the record format of fixed block (FB) is used for the new data set EVER. 


//SMSDS6 DD DSNAME=MYDS6.PGM,DATACLAS=DCLASO6,DISP=(NEW,KEEP), 
// RECFM=FB 


In the example, the record format of fixed block (FB) overrides the record format defined in the 
data class for the data set. 
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| RECORG Parameter 


Parameter Type: Keyword, optional — use this parameter only with SMS 
Without SMS, see the AMP parameter described on page 10-18. 


Purpose: Use the RECORG parameter to specify the organization of the records in a new 
VSAM data set. 


Code the RECORG parameter when you want to (1) specify the record organization for the 
data set or (2) override the record organization defined in the data class of the data set. 


If SMS is not installed or is not active, the system syntax checks and then ignores the 
RECORG parameter. 


References: See MV S/Extended Architecture VSAM Administration Guide for information on 
VSAM data sets. 


Syntax: 


RECORG= 


Subparameter Definition 


Defaults 


KS 

Specifies a VSAM key-sequenced data set. 
ES 

Specifies a VSAM entry-sequenced data set. 
RR 

Specifies a VSAM relative record data set. 
LS 


Specifies a VSAM linear space data set. 


If you do not specify RECORG, SMS assumes a physical sequential (PS) or partitioned (PO) 
data set. 
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Overrides 2 


The RECORG parameter overrides the record organization defined in the data class for the 
data set. 


Relationship to Other Parameters 


Do not code the following DD parameters with the RECORG parameter. 


* DDNAME 
DATA DYNAM 
DCB=DSORG RECFM 
DCB= RECFM 


Example of the RECORG parameter 


//SMSDS3 DD DSNAME=MYDS3.PGM,DATACLAS=VSAM1,DISP=(NEW,KEEP), 
// RECORG=KS 


In the example, the record organization of key-sequenced (KS) overrides the record 
organization defined in the data class. 
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| REFDD Parameter 


Parameter Type: Keyword, optional — use this parameter only with SMS 
Without SMS, use the DCB =*.ddname form of the DCB parameter described on page 10-46. 


Purpose: Use the REFDD parameter to specify the attributes for a new data set by copying 
the attributes of a data set that is defined on an earlier DD statement in the same job. 


The following attributes are copied to the new data set from (1) the attributes specified on the 
referenced DD statement, and (2) for attributes not specified on the referenced DD statement, 
from the data class of the referenced DD statement: 


e Data set organization 

— Record organization (RECORG) or 
— Record format (RECFM) 

Record length (LRECL) 

Key length (KEYLEN) 

Key offset (KEYOFF) 

Space allocation (AVGREC and SPACE) 


If SMS is not installed or is not active, the system syntax checks and then ignores the REFDD 
parameter. 


The retention period (RETPD) or expiration date (EXPDT) is not copied to the new data set. 
Note: Do not use the REFDD parameter to copy attributes from a temporary data set 
(&&dsname), partitioned data set if a member name is included, and relative generation number 


fora GDG. 


Syntax: 


* ,ddname 
REFDD= j *.stepname.ddname 


*,stepname.procstepname.ddname 


Subparameter Definition 


* ddname 

* stepname.ddname 

* stepname. procstepname.ddname 
Specify a backward reference to an earlier DD statement. The referenced DD statement 
cannot name a cataloged data set or refer to another DD statement. 


* ddname 
Specifies the ddname of an earlier DD statement in the same step. 


* stepname.ddname 


Specifies the ddname of a DD statement in an earlier step, stepname, in the same 
job. 
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* stepname.procstepname.ddname 
Specifies the ddname of a DD statement in a cataloged or in-stream procedure 
called by an earlier job step. Stepname is the name of the job step that calls the 
procedure and procstepname is the name of the procedure step that contains the 
DD statement. 


Do not reference a DD * or a DD DATA statement. 


Overrides 


Any attributes specified on the referenced DD statement override the corresponding data class 
attributes of the referenced data set. 


Any attributes you specify on the referencing DD statement with the following parameters 
override the corresponding attributes obtained from the referenced DD statement and the data 
class attributes of the referenced data set. 
j 


RECORG (record organization) or RECFM (record format) 

LRECL (record length) 

KEYLEN (key length) 

KEYOFF (key offset) 

AVGREC (record request and space quantity) 

SPACE (average record length, primary, secondary, and directory quantity) 


Relationship to Other Parameters 


Do not code the following DD parameters with the REFDD parameter. 


DYNAM 
LIKE 


Examples of the REFDD Parameter 


//SMSDS6 DD DSNAME=MYDS6.PGM,DATACLAS=DCLASO1,DISP=(NEW,KEEP), j 
// LRECL=512 ,RECFM=FB 
//SMSDS7 DD DSNAME=MYDS7.PGM,REFDD=*.SMSDS6 ,DISP=(NEW, KEEP) 


In the example, the data set attributes used for MYDS7.PGM are obtained from the referenced 
data set MYDS6.PGM. 


//SMSDS6 DD DSNAME=MYDS6.PGM,DATACLAS=DCLASO1,DISP=(NEW,KEEP), 
Jd LRECL=512 ,RECFM=FB 

//SMSDS8 DD DSNAME=MYDS8.PGM,REFDD=*.SMSDS6,DISP=(NEW,KEEP), 
Ji LRECL=1024 


In the example, the data set attributes used for MYDS8.PGM are obtained from the referenced 
data set MYDS6.PGM. Also, the logical record length of 1024 overrides the logical record 
length obtained from the referenced data set. 
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| RETPD Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the RETPD parameter to specify the retention period for a new data set. After 
the retention period, the data set can be deleted or written over by another data set. 


If the DD statement contains DISP=(NEW,DELETE) or the DISP parameter is omitted to 
default to NEW and DELETE, the system deletes the data set when the step terminates 
normally or abnormally, even though a retention period is also specified. 

Do not specify RETPD for a temporary data set. 

The RETPD parameter achieves the same result as the EXPDT parameter. 


Code the RETPD parameter when you want to (1) specify a retention period for the data set or 
(2) with SMS, override the retention period defined in the data class for the data set. 


Note: Other than information for SMS, this information for the RETPD parameter previously 
appeared under the LABEL RETPD subparameter. 


Syntax: 


RETPD=nnnn 


| Subparameter Definition 


| Overrides 


nnnn 
Specifies the retention period, in days, for the data set. The nnnn is one through four 
decimal digits (0 - 9999). 


The system adds nnnn to the current date to produce an expiration date. The calculated 
expiration date uses 365-day years and 366-day leap years. 


Note: If you code RETPD and the calculated expiration date is December 31, 1999, the 
expiration date is set to January 1, 2000. 


With SMS, RETPD overrides the retention period defined in the data class for the data set. 
With SMS, both the retention period specified on RETPD and defined in the data class for an 


SMS-managed data set can be limited by a maximum retention period defined in the 
management class for the data set. 
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| Relationship to Other Parameters 


| Do not code the following DD parameters with the RETPD parameter. 
| * DYNAM 


| DATA EXPDT 
| DDNAME SYSOUT 


| Deleting a Data Set Before its Retention Period Passes 

| To delete a data set before the retention period has passed, use one of the following: 

| e For data sets cataloged in a VSAM or integrated catalog facility catalog, use the DELETE 
| command, as described in Integrated Catalog Administration: Access Method Services 


| Reference or VSAM Catalog Administration: Access Method Services Reference. 


| e For data sets not cataloged in a VSAM or integrated catalog facility catalog, use the 
| IEHPROGM utility, as described in Data Administration: Utilities. 


| @ For the data set control block (DSCB), use the SCRATCH macro with the OVRD 
| parameter, as described in System-Data Administration. Deletion of the DSCB makes the 
| space occupied by the data set available for reallocation. 


| Examples of the RETPD Parameter 


//DD1 DD DSNAME=HERBI ,DISP=(NEW,KEEP) , UNIT=TAPE, 
iJ VOLUME=SER=T2 , LABEL=(3,NSL) , RETPD=188 


In the example, the data set is not eligible for being deleted or written over for 188 days. 


//SMSDS2. DD DSNAME=MYDS2.PGM,DATACLAS=DCLASO2,DISP=(NEW,KEEP), 
qi RETPD=7 32 


In the example, the retention period of 732 days overrides the retention period defined in the 
data class for the data set. ) 
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| SECMODEL Parameter 


| Parameter Type: Keyword, optional — use this parameter only with SMS 

| Without SMS, use the DD PROTECT parameter described on page 10-132. 

| Purpose: Use the SECMODEL parameter to specify the name of an existing Resource Access 
| Control Facility (RACF) data set profile that is copied to the discrete data set profile that 

| RACF builds for the new data set. 


| The following information from the RACF data set profile, which RACF uses to control access 
| to the data set, is copied to the discrete data set profile of the new data set: 


| @ OWNER - indicates the user or group assigned as the owner of the data set profile. 
| e ID - indicates the access list of users or groups authorized to access the data set. 

| ® UACC - indicates the universal access authority associated with the data set. 

| e AUDIT/GLOBALAUDIT - indicates which access attempts are logged. 

| e ERASE - indicates that the data set is to be erased when it is deleted (scratched). 

| @e LEVEL - indicates the installation-defined level indicator. 

| @ DATA - indicates installation-defined information. 


| e WARNING - indicates that an unauthorized access causes RACF to issue a warning 
| message but allow access to the data set. 


| @ SECLEVEL - indicates the name of an installation-defined security level. 


| Use the SECMODEL parameter (1) when you want a different RACF data set profile than the 
| default profile selected by RACF or (2) when there is no default profile. 


| If SMS is not installed or is not active, the system syntax checks and then ignores the 
| SECMODEL parameter. 


| References: For information about RACF, see MVS Resource Access Control Facility (RACF) 
| Command Language Reference. 


| Syntax: 


| SECMODEL=(profile-name[,GENERIC] ) 
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Subparameter Definition 
profile-name 
Specifies the name of a RACF model profile, discrete data set profile, or generic data 
set profile. The named profile is copied to the discrete data set profile of the new data 
set. 


If a generic data set profile is named, GENERIC must also be coded. 


GENERIC 
Identifies that the profile-name refers to a generic data set profile. 


Overrides 


The SECMODEL parameter overrides the PROTECT = YES parameter. 


Relationship to Other Parameters 


Do not code the following DD parameters with the SECMODEL parameter. 


is DDNAME 
DATA DYNAM 


Examples of the SECMODEL Parameter 
//SMSDS4 DD DSNAME=MYDS4.PGM,SECMODEL=(GROUP4.DEPT1.DATA), 
Uy, DISP= (NEW, KEEP) 


In the example, RACF uses the previously defined model data set profile named 
GROUP4.DEPT1.DATA to control access to the new data set. 


//SMSDS5 DD DSNAME=MYDS5.PGM,SECMODEL=(GROUP5.*,GENERIC), 
7 DISP= (NEW, KEEP) 


In the example, RACF uses the previously defined generic data set profile named 
GROUPS.* to control access to the new data set. 
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SPACE Parameter 


Parameter Type: Keyword, optional 


Note: With SMS, code the SPACE parameter when you want to (1) request space for a new 
data set or (2) override the space allocation defined in the data class for the data set. See the 
DATACLAS parameter (described on page 10-42) and the AVGREC parameter (described 
on page 10-24). 


Purpose: Use the SPACE parameter to request space for a new data set on a direct access 
volume. You can request space in two ways: 


@ Tell the system how much space you want and let the system assign specific tracks. 
e@ Tell the system the specific tracks to be allocated to the data set. 


Letting the system assign the specific tracks is most frequently used. You specify only how 
space 1s to be measured — in tracks, cylinders, blocks, or records — and how many of those 
tracks, cylinders, blocks, or records are required. 


The SPACE parameter has no meaning for tape volumes; however, if you assign a data set 
to a device class that contains both direct access devices and tape devices, for example, 
UNIT =SYSSQ, you should code the SPACE parameter. 


Syntax: 


For system assignment of space: 


TRK, ,CONTIG 

SPACE=| JCYL, primary-gty |,second-qty||,directory|||,RLSE!| | ,MXIG [ ,ROUND ] 
blkligth, ; , index ; , ALX 
reclgth, ; 


To request specific tracks: 


saat ita (ce ie cals ,directory \ 


, index 


To request only directory space: 


SPACE=(,(,,directory) ) 


e You can omit the parentheses around the primary quantity if you do not code secondary, directory, or 
index quantities. For example, SPACE=(TRK,20,RLSE,CONTIG) or SPACE=(TRK,20). Note that, 
if you omit these inner parentheses, you also omit the commas within them. 
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e All the subparameters are positional. Code a comma to indicate an omitted subparameter if any others 
follow. Thus: 


If you code primary and directory or index quantities and omit a secondary quantity, code a 
comma inside the inner parentheses to indicate the omission. For example, SPACE=(TRK,(20,,2)). 


If you omit RLSE but code a following subparameter, code a comma to indicate the omission. For 
example, SPACE =(TRK,(20,10),, CONTIG) or SPACE =(TRK,20,,CONTIG). 


If you omit CONTIG, MXIG, or ALX and ROUND follows, code a comma to indicate the 
omission. For example, SPACE =(400,30,RLSE,,ROUND). If RLSE is also omitted, this example 
becomes SPACE = (400,30,,,ROUND). 


Subparameter Definition 


System Assignment of Space 


TRK 
Requests that space be allocated in tracks. 


CYL 
Requests that space be allocated in cylinders. 


blklgth — (only if AVGREC is not coded) 
Specifies the average block length, in bytes, of the data. The system computes how many 
tracks to allocate. The blklgth is a decimal number from | through 65535. 


reclgth — (only if AVGREC is coded) 
With SMS, specifies the average record length, in bytes, of the data. The system 
computes the block size and how many tracks to allocate. The reclgth is a decimal 
number from 1 through 65535. 


primary-qty 
Specifies one of the following: 


e For TRK, the number of tracks to be allocated. 

e For CYL, the number of cylinders to be allocated. 

e For a block length, the number of data blocks in the data set. 

e Fora record length, the number of records in the new data set. Use the AVGREC 
parameter to specify that the primary quantity represents units, thousands, or millions 
of records. 

Note: When you specify TRK or CYL for a partitioned data set, the primary quantity 

includes the space for the directory. When you specify a block length or record length for 


a partitioned data set, the primary quantity does not include the directory space; the 
system assigns the directory to space outside the primary space assignment. 
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One volume must have enough available space for the primary quantity. If you request a 
particular volume and it does not have enough space available for your request, the 
system terminates the job step. Allow for track overflow when computing track 
requirements. 


To request an entire volume, specify in the primary quantity the number of tracks or 
cylinders on the volume minus the number used by the volume table of contents (VTOC). 
The volume must not contain other data sets. 


second-qty 
Specifies the number of additional tracks, cylinders, blocks, or records to be allocated, if 
more space is needed. The system does not allocate additional space until it is needed. 


With SMS, use the AVGREC parameter to specify that the secondary quantity represents 
units, thousands, or millions of records. 


If the first subparameter specifies the average block length, the system computes the 
number of tracks for the secondary quantity from the second-qty number multiplied by 
one of the following, in order: 


1. The SPACE average block length subparameter. 
2. The block length in the BLKSIZE field of the data control block. 


When you specify a secondary quantity and the data set requires additional space, the 
system allocates the specified quantity: 


1. In contiguous tracks or cylinders, if available. 
2. If not, in up to five extents. 


The system can allocate up to 16 extents for a data set on a volume. An extent is space 
that may or may not be contiguous to other space allocated to the data set. The extents 
for a data set include the primary quantity space and user-label space. 


Note: BDAM data sets cannot be extended. 


When your program has filled a sequential data set’s allocated space on a volume, the 
system determines where the following data is written as follows: 


e If the disposition of the data set is NEW or MOD and the limit on the number of 
extents on a volume has not been reached, the system attempts to allocate the 


secondary quantity on the same volume. 


e Ifthe disposition of the data set is OLD or SHARE, the system examines the next 
volume specified for the data set. 


— If space has been allocated on the next volume for the data set, the next volume 
is used for the data set. 


— If space has not been allocated on the next volume for the data set, secondary 
space is allocated on the next volume for the data set. 


— If there is not another volume specified for the data set, the system attempts to 
allocate the secondary quantity on the current volume. 
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Note that your program should not write with a disposition of DISP=SHR unless 
you take precautions to prevent other programs from writing at the same time. 


If the requested volumes have no more available space and if at least one volume is 
demountable, the system asks the operator to mount scratch (nonspecific) volumes until 
the secondary allocation is complete. If none of the volumes are demountable, the system 
abnormally terminates the job step. 


directory 


index 


Specifies the number of 256-byte records needed in the directory of a partitioned data set. 
Note: When creating a partitioned data set, you must request space for a directory. 


With SMS, you can specify the number of directory records on the SPACE parameter 
without specifying any other subparameters. For example: 


//DD12 DD DSNAME=PDS.EXMP , DATACLAS=DCLAS12,SPACE=(,(,,20)), 
// DISP= (NEW, KEEP) 


specifies 20 directory records for the data set. In this example, the number of specified 
directory records (20) overrides the number of directory records defined in the data class 
of the data set. (SMS uses all other space allocation attributes defined in the data class of 
the data set.) 


For the index of an indexed sequential data set, specifies one of the following: 


e For TRK, the number of tracks needed. The number of tracks must equal one or 
more cylinders. 


e For CYL, the number of cylinders needed. 


RLSE 


Requests that space allocated to an output data set, but not used, is to be released when 
the data set is closed. Unused space is released only if the data set is open for output and 
the last operation was a write. 


If you specify RLSE and an abnormal termination occurs, the system does not release 
unused space even though the data set is open. 


Do not code the RLSE subparameter for an indexed sequential data set. 


Coding RLSE for primary allocation does not prohibit use of secondary allocation. The 
secondary request for space is still in effect. 


The system ignores a request to release unused space when a data set is closed if: 
e Another job is sharing the data set. 


e Another task in the same job is processing an OPEN, CLOSE, EOV, or FEOV 
request for the data set. 


e Another data control block is open for the data set. 
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The RLSE subparameter 1s ignored when TYPE=T is coded in the CLOSE macro 
instruction. 


When coding RLSE for an existing data set, code the unit of measurement and primary 
quantity as they appeared in the original request. For example, if the original request 
was: 


SPACE=(TRK, (100,50) ) 


you can release unused tracks when you retrieve the data set by coding: 
SPACE=(TRK, (100) , RLSE) 
CONTIG 


Requests that space allocated to the data set must be contiguous. This subparameter 
affects only primary space allocation. 


If CONTIG is specified and contiguous space is not available, the system terminates the 
job step. 


MXIG 
Requests that space allocated to the data set must be (1) the largest area of available 
contiguous space on the volume and (2) equal to or greater than the primary quantity. 
This subparameter affects only primary space allocation. 


Note: Do not code a MXIG subparameter for an indexed sequential data set. 


Requests that up to five separate areas of contiguous space are to be allocated to the data 
set and each area must be equal to or greater than the primary quantity. This 
subparameter affects only primary space allocation. 


Note: Do not code an ALX subparameter for an indexed sequential data set. 


ROUND 
When the first subparameter specifies the average block length, requests that space 
allocated to the data set must be equal to an integral number of cylinders. If the first 
subparameter specifies TRK, CYL, or reclgth, the system ignores ROUND. 


Request for Specific Tracks 
For an SMS-managed data set (one with an assigned storage class), do not code ABSTR. 


ABSTR 
Requests that the data set be allocated at the specified location on the volume. 


primary-qty 
Specifies the number of tracks to be allocated to the data set. 


The volume must have enough available space for the primary quantity. If it does not, 
the system terminates the job step. 
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address 
Specifies the track number of the first track to be allocated. Count the first track of the 
first cylinder on the volume as 0. Count through the tracks on each cylinder until you 
reach the track on which you want the data set to start. 


Note: Do not request track 0. 


directory 
Specifies the number of 256-byte records needed in the directory of a partitioned data set. 


Note: When creating a partitioned data set, you must request space for a directory. 


index 
Specifies the number of tracks needed for the index of an indexed sequential data set. 
The number of tracks must equal one or more cylinders. 


Relationship to Other Parameters 


Do not code the following parameters with the SPACE parameter. 


= DYNAM 
DATA QNAME 
DDNAME SUBSYS 


With KEYLEN for Block Requests: If space is requested in blocks and the blocks have keys, 
code the DD parameter KEYLEN (or the DCB subparameter KEYLEN) on the DD statement 
and specify the key length. 


SPACE for New Data Sets with SMS 


With SMS, code the SPACE parameter with or without the AVGREC parameter when you 
want to (1) request space for the data set or (2) override the space allocation attributes defined 
in the data class for the data set. 


SPACE for New Data Sets on Mass Storage Volumes 


e The SPACE parameter must be coded for new data sets on mass storage volumes when 
VOLUME =SER is coded. It is optional when MSVGP is coded. If you code neither 
VOLUME =SER nor MSVGP, SPACE must be coded even if you code 
VOLUME = PRIVATE. 


e Contiguous space is the MSVGP default. If you want a noncontiguous primary space 
allocation, you must specify the SPACE parameter. 
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Examples of the SPACE Parameter 


//DD1 DD DSNAME=&&TEMP , UNIT=MIXED,SPACE=(CYL,10) 


The DD statement defines a temporary data set. The UNIT parameter requests any available 
tape or direct access volume; MIXED is the installation’s name for a group of tape and direct 
access devices. If a tape volume is assigned, the SPACE parameter is ignored; if a direct access 
volume is assigned, the SPACE parameter is used to allocate space to the data set. The SPACE 
parameter specifies only the required subparameters: the type of allocation and a primary 
quantity. It requests that the system allocate 10 cylinders. 


//DD2 DD DSNAME=PDS12,DISP=(,KEEP) ,UNIT=3350, 
// VOLUME=SER=25143 ,SPACE=(CYL,(10,,10),,CONTIG) 


The DD statement defines a new partitioned data set. The system allocates 10 cylinders to the 
data set, of which ten 256-byte records are for a directory. Since the CONTIG subparameter 1s 
coded, the system allocates 10 contiguous cylinders on the volume. 


//REQUEST1 DD DSNAME=EXM,DISP=NEW, UNIT=3330,VOLUME=SER=606674, 
aes SPACE=(1024,75) ,DCB=KEYLEN=8 

//REQUESTA DD DSNAME=EXQ,DISP=NEW, UNIT=3380, 

Jf SPACE=(1024,75) ,DCB=KEYLEN=8 


These DD statements request space in block lengths. The average block length of the data is 
1024 bytes. 75 blocks of data are expected as output. Each block is preceded by a key eight 
bytes long. The system computes how many tracks are needed, depending on the device 
requested in the UNIT parameter. 


//REQUEST2 DD DSNAME=PET,DISP=NEW, UNIT=3330,VOLUME=SER=606674, 
// SPACE=(ABSTR, (5,1) ) 


In this example, the SPACE parameter asks the system to allocate 5 tracks, beginning on the 
second track of the volume. 


//DD3 DD DSNAME=MULTIVOL,UNIT=3350,DISP=(,CATLG), 
// VOLUME=SER= (223344,223345) ,SPACE=(CYL, (554,554) ) 


This example shows how to create a multivolume data set on two complete volumes. The two 
volumes do not contain other data sets. A volume on 3350 Direct Access Storage contains 555 
cylinders. The unrequested cylinder contains the volume table of contents (VTOC). 


//SMSDS3 DD DSNAME=MYDS3.PGM,DATACLAS=DCLASO3,DISP=(NEW,KEEP), 
yy SPACE=(128,(5,2)) ,AVGREC=K 


In this example, the space allocation defined in the DCLASO3 data class is overridden by the 


SPACE and AVGREC parameters, which indicate an average record length of 128 bytes, a 
primary quantity of 5K (5,120) records, and a secondary quantity of 2K (2,048) records. 
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| STORCLAS Parameter 


| Parameter Type: Keyword, optional — use this parameter only with SMS and for 
| SMS-managed data sets 


| Without SMS or for non-SMS-managed data sets, use the UNIT parameter (described on page 
| 10-173) and the VOLUME parameter (described on page 10-178). 


Purpose: Use the STORCLAS parameter to specify a storage class for a new SMS-managed 
data set. The storage administrator at your installation defines the names of the storage classes 
you can code on the STORCLAS parameter. 


The storage class contains the attributes that identify a storage service level to be used by SMS 
for storage of the data set. It replaces the storage attributes that are specified on the UNIT and 
VOLUME parameters for non-SMS-managed data sets. 


An SMS-managed data set is defined as a data set that has a storage class assigned. A storage 
class is assigned when either (1) you specify the STORCLAS parameter or (2) an 

| installation-written automatic class selection (ACS) routine selects a storage class for a new data 
set. 


| If SMS is not installed or is not active, the system syntax checks and then ignores the 
| STORCLAS parameter. 


| SMS ignores the STORCLAS parameter if you specify it for an existing data set. 
The use of a storage class can be protected by RACF. j 


References: See MVS/XA Interactive Storage Management Facility User's Guide for 
information on how to use ISMF to view your installation-defined storage classes. 


Syntax: 


STORCLAS=storage-class-—name 


Subparameter Definition 


storage-class-name 
Specifies the name of a storage class to be used for storage of the data set. 


The name, one to eight characters, is defined by the storage administrator at your 
installation. 
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Defaults 


Overrides 


DD: STORCLAS 


If you do not specify STORCLAS for a new data set and the storage administrator has 
provided an installation-written automatic class selection (ACS) routine, the ACS routine may 
select a storage class for the data set. Check with your storage administrator to determine if an 
ACS routine will select a storage class for the new data set, in which case you do not need to 
specify STORCLAS. 


No attributes in the storage class can be overridden by JCL parameters. 


An ACS routine can override the storage class that you specify on the STORCLAS parameter. 


Relationship to Other Parameters 


If the storage administrator has specified GUARANTEED _SPACE= YES in the storage class, 
then volume serial numbers you specify on the VOLUME=SER parameter override the volume 
serial numbers used by SMS. Otherwise, volume serial numbers are ignored. 


Do not code the following DD parameters with the STORCLAS parameter. 


t DYNAM UNIT =AFF 
DATA QNAME VOLUME= REF 
DDNAME 


Examples of the STORCLAS Parameter 


//SMSDS1 DD DSNAME=MYDS1.PGM,STORCLAS=SCLASO1,DISP=(NEW, KEEP) 


In the example, SMS uses the attributes in the storage class named SCLASO1 for the storage 
service level of the data set. Note that installation-written ACS routines may select a 
management class and data class and can override the specified storage class. 


//SMSDS2. DD DSNAME=MYDS2.PGM,STORCLAS=SCLASO2 ,DISP=(NEW,KEEP), 
// VOLUME=SER=(223344,224444) 


In the example, SMS uses the attributes in the storage class named SCLAS02 for the storage 
service level of the data set. Also, if the storage administrator has specified 
GUARANTEED_SPACE = YES in the storage class, VOLUME=SER can be coded and the 
data set will reside on the specified volumes. (However, if space is not available on the 
volumes, the job step fails.) Note that installation-written ACS routines may select a 
management class and data class and can override the specified storage class. 
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SUBSYS Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the SUBSYS parameter to request a subsystem to process this data set and, 
optionally, to specify parameters defined by the subsystem. 


Do not use the SUBSYS parameter for an SMS-managed data set (one with an assigned storage 
class). 


In a loosely-coupled multiprocessing environment, the requested subsystem must be defined on 
all processors that could interpret this DD statement. 


References: For more information on the SUBSYS parameter and subsystem-defined 
parameters, refer to the documentation for the requested subsystem. 


Syntax: 


SUBSYS= |subsystem-name 
(subsystem-name[,subsystem-subparameter]...) 


Single Subparameter: You can omit the parentheses if you code only the subsystem-name. 
Number of Subparameters: Code up to 254 subsystem-subparameters, if needed. 
Multiple Subparameters: When the parameter contains more than the subsystem-name, 


separate the subparameters by commas and enclose the subparameter list in parentheses. 
For example, SUBSYS = (XYZ,1724,DT25). 


Positional Subparameters: If you omit a subparameter that the subsystem considers 


positional, code a comma in its place. 


Special Characters: When a subparameter contains special characters, enclose the 
subparameter in apostrophes. For example, SUBSYS=(XYZ,1724,’KEY=Y’). 


Code each apostrophe that is part of a subparameter as two consecutive apostrophes. For ail 
example, code O’Day as SUBSYS = (XYX,1724,,NAME=O”’ DAY’). 


Continuation onto Another Statement: Enclose the subparameter list in only one set of 
parentheses. End each statement with a comma after a complete subparameter. For 
example: 


//DS1 DD DSNAME=DATA1,SUBSYS=(XYZ,1724,'KEY=Y', 
// DT25,'NAME=O' 'DAY') 
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Subparameter Definition 


subsystem-name 
Identifies the subsystem. The subsystem name is | through 4 alphanumeric or national (§, 
#, @) characters; the first character must be alphabetic or national ($, #, @). The 
subsystem must be available in the installation. 


subsystem-subparameter 


Specifies information needed by the subsystem. A subparameter consists of alphanumeric, 
national ($, #, @), or special characters. 


Relationship to Other Parameters 


Do not code the following DD parameters with the SUBSYS parameter. 


* DYNAM 
AMP FLASH 
BURST MODIFY 
CHARS QNAME 
COPIES SPACE 
DATA SYSOUT 
DDNAME 


The specified subsystem can define other parameters that must not be coded with the SUBSYS 
parameter. 


Ignored but Permitted DD Parameters: If the following DD parameters are specified, they are 
checked for syntax and ignored: 


FCB 
UNIT 


DISP Parameter: The system checks the DISP status subparameter for syntax, but always 
indicates a status of MOD to the subsystem. If the DISP normal or abnormal termination 
subparameter is CATLG or UNCATLG, the system allocates the appropriate catalog to the 
subsystem. 


DUMMY Parameter: If DUMMY is specified with SUBSYS, the subsystem checks the syntax 
of the subsystem subparameters. If they are acceptable, the system treats the data set as a 
dummy data set. 


When This Statement Overrides a Procedure Statement: If SUBSYS appears on a DD 
statement that overrides a DD statement in a cataloged or in-stream procedure, the following 


occurs: 


@ The system ignores a UNIT parameter, if specified, on the overridden DD statement. 
e The system nullifies a DUMMY parameter, if specified, on the overridden DD statement. 
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Examples of the SUBSYS Parameter 


//DD1 DD DSNAME=ANYDS,DISP=OLD,SUBSYS=ABC 


The DD statement asks subsystem ABC to process data set ANYDS. 


//DD1 DD DSNAME=ANYDS , DISP=OLD,SUBSYS=(XYZ2, 
Th 'KEYWORD=DATA VALUE1' ) 


The DD statement asks subsystem XYZ2 to process data set ANYDS. The system passes the 
subparameter KEYWORD =DATA VALUEI to the subsystem. The parameter is enclosed in 
apostrophes because it contains an equal] sign and a blank, which are special characters. 


//DD1 DD DSNAME=ANYDS,DISP=OLD,SUBSYS=(XYZ2,IKJ2, 
Jif 'NAME=''MODULE1''', 'DATE=4/11/86' ) 


The DD statement asks subsystem XYZ2 to process the data set ANYDS. The system passes 
three subparameters to the subsystem: IKJ2, NAME=’MODULEI’ and DATE =4/11/86. 
Note that the character string MODULE] is passed to the subsystem enclosed in apostrophes. 
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SYSOUT Parameter 


Parameter Type: Keyword, optional 


Do not use the SYSOUT parameter for an SMS-managed data set (one with an assigned 
storage class). 


Purpose: Use the SYSOUT parameter to identify this data set as a system output data set, 
usually called a sysout data set. The SYSOUT parameter also: 


e Assigns this sysout data set to an output class. The attributes of each output class are 
defined during JES initialization; the attributes include the device or devices for the output 


class. 


@ Optionally requests an external writer to process the sysout data set rather than JES. An 
external writer is an IBM- or installation-written program. 


e Optionally identifies the forms on which the data set is to be printed or punched. 
e Optionally refers to a JES2 /‘OUTPUT statement for processing parameters. 


The sysout data set is processed according to the following processing options, in override 
order: 


@ The options specified on this sysout DD statement. 
@ The options specified on a referenced OUTPUT JCL statement. 


@ The options specified on a referenced JES2 /“OUTPUT statement or on a JES3 
//*FORMAT statement. 


e The installation default options for the requested output class. 


Note: If a sysout data set has the same class as the JOB statement MSGCLASS parameter, the 
job log appears on the same output listing as this sysout data set. 


Output Classes: The installation should maintain a list of available output classes and their 
attributes. Some classes should be used for most printing and punching, but others should be 
reserved for special processing. Each class is processed by an output writer. The system 
operator starts the output writers for the commonly used output classes. If you plan to specify 
a special output class, ask the operator to start the output writer for that class. If the writer is 
not started before the job produces the sysout data set, the data set is retained until the writer is 
started. 


References: For information on output writers and external writers, see SPL: System 
Modifications. 
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Syntax: 


class 


, LNTRDR ,code-name 


, 


SYSOUT= [suse chasse ,Lorm-name } 


* 


SYSOUT=(,) 


You can omit the parentheses if you code only a class. 


All of the subparameters are positional. Code a comma to indicate an omitted 
subparameter as follows: 


If you omit the class, code a comma to indicate the omission. For example, when 
other subparameters follow, code SYSOUT =(INTRDR,FM26). When other 
subparameters do not follow, code a null class as SYSOUT =(,). 


If you omit a writer-name but code a form-name or code-name, code a comma to 
indicate the omission. For example, SYSOUT =(A,,FM26). 


Omission of the third subparameter does not require a comma. For example, 
SYSOUT =A or SYSOUT =(A,INTRDR). 


Subparameter Definition 


class 
Identifies the output class for the data set. class is one character: A through Z or 0 
through 9. The attributes of each output class are defined during JES initialization; 
specify the class with the desired attributes. 


Requests the output class in the MSGCLASS parameter on the JOB statement. 
In a JES2 system, the dollar-sign ($) can also be used to request the output class in the 


MSGCLASS parameter on the JOB statement. The $ is provided only for compatibility 
with previous releases of JES2. The asterisk (*) value should be used instead of the $. 


(;) 
Specifies a null class. A null class must be coded to use the CLASS parameter on a 
referenced OUTPUT JCL statement. 

writer-name 


Identifies the member name (1 to 8 alphanumeric characters) of an installation-written 
program in the system library that the external writer loads to write the output data set. 


Do not code STDWTR as a writer-name. STDWTR is reserved for JES and used as a 
parameter in the MVS operator’s MODIFY command. 
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Defaults 


Overrides 


DD: SYSOUT 


In a JES3 system, do not code NJERDR as a writer-name. NJERDR is reserved for 
JES3. 


INTRDR 
Tells JES that this sysout data set is to be sent to the internal reader as an input job 
stream. 


form-name 
Identifies the print or punch forms. form-name is | through 4 alphanumeric or national 
($, #, @) characters. 


code-name 
Identifies an earlier JES2 /“OUTPUT statement from which JES2 is to obtain processing 
characteristics. The code-name must be the same as the code parameter on the JES2 
/*OUTPUT statement. 


Note: 
® code-name is supported only on JES2 systems. 


® Do not specify the code-name subparameter when the job or job step contains a 
default OUTPUT JCL statement. 


In a JES2 system, if you do not specify a class on this DD statement or a referenced OUTPUT 
JCL statement, JES2 assigns the sysout data set to output class A. 


If you do not code a writer-name subparameter on this DD statement or a referenced 
OUTPUT JCL statement, the installation’s job entry subsystem processes the sysout data set. 


If you do not code a form-name subparameter on this DD statement or a referenced OUTPUT 
JCL statement, JES uses an installation default specified at initialization. 


The class subparameter of the DD statement SYSOUT parameter overrides an OUTPUT JCL 
CLASS parameter. On the DD statement, you must code a null class in order to use the 
OUTPUT JCL CLASS parameter; for example: 


//OUTDS DD SYSOUT=(,) ,OUTPUT=* .OUT1 


The writer-name subparameter of the DD statement SYSOUT parameter overrides an 
OUTPUT JCL WRITER parameter. 


The form-name subparameter of the DD statement SYSOUT parameter overrides an OUTPUT 
JCL FORMS parameter. Note that the SYSOUT form-name subparameter can be only four 
characters maximum while both the OUTPUT JCL FORMS form-name and the JES 
Initialization default form names can be eight characters maximum. 
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Relationship to Other Parameters 


Do not code the following DD parameters with the SYSOUT parameter. 


. DSNAME PROTECT 
AMP DYNAM QNAME 
CHKPT EXPDT RETPD 
DATA LABEL SUBSYS 
DDNAME LIKE VOLUME 
DISP MSVGP 


Ignored Parameters: Because JES allocates sysout data sets, the UNIT and SPACE parameters 
are ignored, if coded on a sysout DD statement. 


Parameters on Procedure DD Statements that are Overridden: When an overriding DD 
statement contains a SYSOUT parameter, the system ignores a UNIT parameter on the 
overridden DD statement in the cataloged or in-stream procedure. 


If the overridden DD statement contains a DSNAME parameter, the system issues a JCL ) 
warning message. 


SYSOUT and DEST Subparameters: Do not code the SYSOUT writer-name subparameter 
when coding a DEST userid subparameter. These subparameters are mutually exclusive. You 
can code: 


//VALID1L DD SYSOUT=D,DEST=(node,userid) 
//VALID2 DD SYSOUT=(D,writer-name) , DEST=(node) 


With DCB Subparameters: JES2 ignores DCB=PRTSP=2 on a DD statement that also ) 
contains a SYSOUT parameter. 


For JES2, it is not necessary to select a specific BLKSIZE on the DCB parameter for 
performance reasons because the subsystem selects its own blocking and overrides the DCB 
BLKSIZE specification. 


INTRDR with OUTPUT Parameter: Do not code an OUTPUT parameter when the 
writer-name subparameter is INTRDR. 


Relationship to Other Control Statements J 


A sysout DD statement can directly or indirectly reference an OUTPUT JCL statement. The 
parameters on the referenced OUTPUT JCL statement combine with the parameters on the 
sysout DD statement to control the processing of the sysout data set. See “OUTPUT 
Parameter” on page 10-128 and Chapter 17, “OUTPUT JCL Statement.” 


SYSOUT cannot specify a code-name subparameter in a job or job step that contains an 
OUTPUT JCL statement; in this case, JES2 treats the third subparameter as a form-name, 
instead of a reference to a JES2 /*“OUTPUT statement. 


Backward References: Do not refer to a earlier DD statement that contains a SYSOUT 
parameter. 
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Starting an External Writer when Requested 
When a statement supplying processing options for a sysout data set specifies an external writer, 
the writer must be started before it can print or punch the data set. The writer is started by a 


system command from the operator or in the input stream. If the writer is not started before 
the job produces the sysout data set, the data set is retained until the writer is started. 


Held Classes in a JES2 System 


An installation option at JES2 initialization determines if both the class for the sysout data set 
and the class for the job’s messages must be held in order for a sysout data set to be held. 


A sysout data set is held in the following cases: 
e The sysout DD statement contains HOLD= YES. 


e The sysout DD statement does not contain a HOLD parameter or contains HOLD=NO 
but requests a class that the installation defined as held and defined as: . 


— Not requiring the message class to be a held class in order for the sysout data set to be 
held. The JOB statement MSGCLASS parameter can specify any class. 


— Requiring the message class to be a held class in order for the sysout data set to be 
held. The JOB MSGCLASS parameter must also specify a held class. 


A sysout data set is not held in the following cases: 


e The sysout DD statement does not contain a HOLD parameter or contains HOLD=NO 
and requests: 


— Acclass that the installation defined as not held. 
— Acclass that the installation defined as held and defined as requiring the message class 
to be a held class in order for the sysout data set to be held. The JOB MSGCLASS 


parameter must specify a class that is not held. 


Contact the installation to find out if holding the sysout class depends on a held MSGCLASS 
class. 


Held Classes in a JES3 System 


If CLASS specifies a class-name that is defined to JES3 as a held class for the output service 
hold queue (Q=HOLD), all of the new output characteristics might not be included in the data 
set on the writer queue when (1) the data set is moved from the hold queue to the output 
service writer queue (Q= WTR), (2) the data set includes an OUTPUT JCL statement, and (3) 
the NQ= or NCL= keyword is used. 


For more information, see MVS/XA SPL: JES3 Initialization and Tuning. 
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Significance of Output Classes 


To print this sysout data set and the messages from your job on the same output listing, code J 
one of the following: 


@ The same output class in the DD SYSOUT parameter as in the JOB MSGCLASS 
parameter. 


e DD SYSOUT=* to default to the JOB MSGCLASS output class. 
e DD SYSOUT=() to default to one of the following: 
1. The CLASS parameter in an explicitly or implicitly referenced OUTPUT JCL 
statement. In this case, the OUTPUT JCL CLASS parameter should specify the same 
output class as the JOB MSGCLASS parameter. 


2. The JOB MSGCLASS output class, if no OUTPUT JCL statement is referenced or if 
the referenced OUTPUT JCL statement contains CLASS =*. 


Examples of the SYSOUT Parameter 


//DD1 DD SYSOUT=P 


In this example, the DD statement specifies that JES is to write the sysout data set to the device 
handling class P output. 


//3OB50 JOB ,'C. BROWN' ,MSGCLASS=C 
//STEP1 EXEC PGM=SET 
/ /DDX DD SYSOUT=C 


In this example, DD statement DDX specifies that JES is to write the sysout data set to the 
device handling class C output. Because the SYSOUT parameter and the MSGCLASS 
parameter specify the same class, the messages from this job and the sysout data set can be 
written to the same device. 
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//STEP1 EXEC PGM=ANS 
//OT1 OUTPUT DEST=NYC 


//OT2 OUTPUT DEST=LAX 
//OT3 OUTPUT COPIES=5 
//DSA DD SYSOUT=H , OUTPUT=(*.OT2,*.OT1,*.OT3) 


In this example, the DD statement combines with the three referenced OUTPUT JCL 
statements to create three separate sets of output: 


1. DSA combines with OT1 to send the sysout data set to NYC. 
2. DSA combines with OT2 to send the sysout data set to LAX. 


3. DSA combines with OT3 to print five copies of the data set locally on the printer used for 
output class H. 


Note that the output references can be in any order. 


//DD5 DD SYSOUT=(F,,2PRT) 


In this example, the DD statement specifies that JES is to write the sysout data set to the device 
handling class F output. The data set is to be printed or punched on forms named 2PRT. 


//JOB51 JOB ACCT123 ,MAEBIRD ,MSGCLASS=B 
//STEP1 EXEC PGM=RPTWTR 

//OUT1 OUTPUT CLASS=* 

//REPORT DD SYSOUT=(,) ,OUTPUT=* .OUT1 


In this example, JES processes the sysout data set defined in DD statement REPORT in output 
class B. Because SYSOUT specifies a null class, the CLASS parameter in the explicitly 
referenced OUTPUT JCL statement is used. That CLASS parameter specifies the MSGCLASS 
output class. 
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TERM Parameter 


Parameter Type: Keyword, optional 


Do not use the TERM parameter for an SMS-managed data set (one with an assigned storage 
class). 


Purpose: Use the TERM parameter to indicate to the system that a data set is coming from or 
going to a terminal for a TSO user. 


Syntax: 


TERM=TS 


Subparameter Definition ») 
TS 
In a foreground job submitted by a TSO user, indicates that the input or output data set is 
coming from or going to a TSO userid. 
In a background or batch job, the system either: 


e Ignores the TERM=TS parameter, when it appears with other parameters. 


@ Fails the TERM=TS parameter with an allocation error, when it appears by itself. J 
(The system bypasses this error if SYSOUT =* is coded with TERM = TS.) 


Relationship to Other Parameters 


Do not code the following DD parameters with the TERM parameter. 


* DYNAM 

AMP PROTECT 
DATA QNAME ) 
DDNAME 


Code only the DCB and SYSOUT parameters with the TERM parameter. The system ignores 
any other DD parameters. 


Location in the JCL 


In a foreground TSO job, a DD statement containing TERM =TS and a SYSOUT parameter 
begins an in-stream data set. 


When concatenating DD statements, the DD statement that contains TERM=TS must be the 
last DD statement in a job step. 
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Examples of the TERM Parameter 


//DD1 DD TERM=TS 


In a foreground job submitted from a TSO userid, this DD statement defines a data set coming 
from or going to the TSO userid. 


//DD1 DD TERM=TS,SYSOUT=* 


In a background or batch job, the system ignores TERM =TS and recognizes a sysout data set. 
(An allocation error occurs if SYSOUT =* is not coded with TERM =TS.) 


//DD3 DD UNIT=3400-5,DISP=(MOD,PASS) , TERM=TS,LABEL=(,NL), 
// DCB= (LRECL=80 , BLKSIZE=80) 


In a foreground job, the system ignores all of the parameters in this example except TERM and 
DCB. Ina batch job, the system ignores only the TERM parameter. 


Chapter 10. DD Statement 10-169 


DD: UCS 


UCS Parameter 


Parameter Type: Keyword, optional 
Purpose: Use the UCS parameter to identify: 
@ The universal character set (UCS) image JES is to use in printing this sysout data set. 


e A print train (print chain or print band) JES is to use in printing this sysout data set on an 
impact printer. 


@ A character-arrangement table for this sysout data set printed on 3800 Printing Subsystem 
in a JES2 system. In this use, the UCS parameter acts like a CHARS parameter. 


The UCS image specifies the special character set to be used. JES loads the image into the 
printer’s buffer. The UCS image is stored in SYS1.IMAGELIB. IBM provides the special | 
character set codes in Figure 10-2. j 


References: For more information on the UCS parameter, see System-Data Administration. 


Syntax: 


UCS= |character-set-code 
(character-set-code “abil (isha 


Lf 


@ You can omit the parentheses if you code only a character-set-code. 


e All of the subparameters are positional. If you omit FOLD but code VERIFY, code a 
comma to indicate the omission. For example, UCS=(AN,,VERIFY). 


Subparameter Definition 


character-set-code . 


Identifies a universal character set. The character-set-code is 1 through 4 alphanumeric or 
national ($, #, @) characters. See Figure 10-2 for IBM standard special character set 
codes. 


FOLD 
Requests that the chain or train for the universal character set be loaded in fold mode. 
Fold mode is described in IBM 2821 Control Unit Component Description. Fold mode is 
most often used when upper- and lower-case data is to be printed only in uppercase. 


Note: JES2 and JES3 do not support the FOLD subparameter. For JES2, the FOLD 
option is specified in the UCS image for JES2-controlled printers. See MV S/XA 
System-Data Administration. 
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Defaults 


Overrides 


DD: UCS 


VERIFY 
Requests that, before the data set is printed, the operator verify visually that the character 
set image is for the correct chain or train. The character set image is displayed on the 
printer before the data set is printed. 


3203 3211 Characteristics 
Model 5 


Arrangement A, standard EBCDIC character set, 48 characters 

Arrangement H, EBCDIC character set for FORTRAN and COBOL, 48 characters 
ASCII character set 

Preferred alphanumeric character set, arrangement A 

Preferred alphanumeric character set, arrangement H 

PL/I alphanumeric character set 

PL/I preferred alphanumeric character set for scientific applications 

PL/1 preferred alphanumeric character set for commercial applications 
Preferred character set for commercial applications of FORTRAN and COBOL 
Preferred character set for text printing 

Character set for text printing, 120 characters 

High-speed alphanumeric character set for 1403, Model 2 

High-speed preferred alphanumeric character set for 1403, Model N1 


Note: Where three values exist (for the 1403, 3211, and 3203 Model 5 printers), code any one of them. JES 
selects the set corresponding to the device on which the data set is printed. 


Not all of these character sets may be available at your installation. Also, an installation can design 
character sets to meet special needs and assign a unique code to them. Follow installation procedures 
for using character sets. 


Figure 10-2. Special Character Sets for the 1403, 3203 Model 5, and 3211 Printers 


If you do not code the UCS parameter, the system checks the UCS image in the printer’s 
buffer; if it is a default image, as indicated by its first byte, JES uses it. If it is not a default 
image, JES loads the UCS image that is the installation default specified at JES initialization. 


On an impact printer, if the chain or train does not contain a valid character set, JES asks the 
operator to specify a character set and to mount the corresponding chain or train. 


For printing on a printer with the UCS feature, the UCS parameter on a sysout DD statement 
overrides an OUTPUT JCL UCS parameter. For printing on a 3800, a CHARS parameter on 
the sysout DD statement or the OUTPUT JCL statement overrides all UCS parameters. 


For a data set scheduled to the Print Services Facility (PSF), the PSF uses the following 
parameters, in override order, to select the font list: 


Font list in the library member specified by an OUTPUT JCL PAGEDEF parameter. 
DD CHARS parameter. 

OUTPUT JCL CHARS parameter. 

DD UCS parameter. 

OUTPUT JCL UCS parameter. 


se 
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6. JES installation default for the device. | 
7. Font list on the PAGEDEF parameter in the PSF cataloged procedure. ) 


See “PAGEDEF Parameter” on page 17-51 for more information. 


Relationship to Other Parameters 


Do not code the following DD parameters with the UCS parameter. 


- DYNAM 
AMP KEYOFF 
DATA PROTECT 


DDNAME QNAME 


Do not code the UCS parameter with the DCB subparameters CYLOFL, INTVL, RESERVE, 
and RKP. 


Do not code the FOLD and VERIFY subparameters on the same statement with a SYSOUT ) 
parameter; the system ignores FOLD and VERIFY for a sysout data set. 


Using Special Character Sets 
To use a special character set, SYS1.IMAGELIB must contain an image of the character set, 


and the chain or train for the character set must be available. IBM provides standard special 
character sets, and the installation may provide user-designed special character sets. 


Examples of the UCS Parameter J 


//DD1 DD UNIT=1403,UCS=(YN, , VERIFY) 
In this example, the DD statement requests a 1403 Printer. The UCS parameter requests the 
chain or train for special character set code YN. Because VERIFY 1s coded, the system will 


display the character set image on the printer before the data set is printed. 


//DD2 DD SYSOUT=G,UCS=PN 


In this example, the DD statement requests the device for output class G. If the device is a 
printer with the UCS feature, the system loads the UCS image for code PN. If the device is an 
impact printer, the system asks the operator to mount the chain or train for PN, if it is not 
already mounted. If the device is a 3800, the system uses the UCS subparameter to select the 
character-arrangement table. Otherwise, the system ignores the UCS parameter. 
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UNIT Parameter 


Parameter Type: Keyword, optional 


Note: With SMS, you do not need to use the UNIT parameter to specify a device for an 
SMS-managed data set. Use the STORCLAS parameter (described on page 10-156) or let an 
installation-written automatic class selection (ACS) routine select a storage class for the data 
set. 


Also with SMS, for a non-SMS-managed data set, if your storage administrator has set a 
system default unit under SMS, you do not need to specify UNIT. Check with your storage 
administrator. 


Purpose: Use the UNIT parameter to ask the system to place the data set on: 
e A specific device. 
e A certain type or group of devices. 


e The same device as another data set. 


The UNIT parameter can also tell the system how many devices to assign and request that the 
operator should defer mounting the volume until the data set is opened. 


Syntax: 


device-number ||,unit-count 
UNIT=| |device-type [, DEFER] 


group-name 


UNIT=AFF=ddname 


You can omit the parentheses if you code only the first subparameter: 


All of the subparameters are positional. If you omit unit-count or P but code DEFER, 
code a comma to indicate the omission; one device is assigned to the data set. For 
example, UNIT = (3420,, DEFER). 


Subparameter Definition 


device-number 
Identifies a particular device. device-number is the 3-character hexadecimal number for 
the device. 


Warning: Do not identify a device by its number unless absolutely necessary. Specifying a 
device number limits device assignment; it will delay a job if another job is using the 
device. 


In a JES3 system, if any DD UNIT parameter in a job specifies a device-number for a 
device that is JES3-managed or jointly JES3/MVS managed, the JES3 //*MAIN statement 
must contain a SYSTEM parameter. 
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However, for a permanently mounted direct access device, such as a 3350 Direct Access | 
Storage, specifying UNIT = 3350 and a volume serial number in the VOLUME=SER ; 
parameter has the same result as specifying a device number in the UNIT parameter. 


device-type 
Requests a device by its generic name, which is an IBM-supplied name that identifies a 
device by its machine type and model. For example, UNIT = 3350. 


When a device-type name contains a hyphen, do not enclose it in apostrophes, for 
example, UNIT =3400-5. 


Obtain a list of device types from your installation. 

Rules for Certain Devices: 

e For a 3330 Disk Storage Model 11, code UNIT = 3330-1. 

e If your installation has 3340 Direct Access Storage Facilities both with and without 


the Fixed Head feature, do not code the device type in the UNIT parameter. Instead, 
code the device number or a group-name. 


e For a 3480 Magnetic Tape Subsystem in compatibility mode, code UNIT =3400-9 or 
a group-name. 


e For mass storage volumes, code UNIT =3330V. 


group-name J 
Requests a group of devices by a symbolic name. The installation must have assigned the ) 
name to the device(s) during system generation or IBM must have assigned the name. 

The group-name is | through 8 alphanumeric characters. 


Group Names: A group-name can identify a single device or a group of devices. A group 
can consist of devices of the same or different types. For example, a group can contain 
both direct access and tape devices. 


Allocation from Groups: The system assigns any available device from the group. Ifa 

group consists of only one device, the system assigns that device. If the group consists of | - 
more than one device type, the units requested are allocated from the same device type. 

For example, if GPDA contains 3330 Disk Storage and 3350 Direct Access Storage 

devices, a request for two units would be allocated to two 3330s or to two 3350s. 


Extending Data Set: If a data set that was created using the group-name subparameter is 
to be extended, the system allocates additional devices of the same type as the original 
devices. However, the additional devices may not necessarily be from the same group. 


SYSALLDA: IBM assigned group-names include SYSALLDA, which contains all direct 
access devices defined to the system. 


unit-count 
Specifies the number of devices for the data set. The unit-count is a decimal number from 
1 through 59. 


Number of Devices Allocated: The system uses the unit-count to determine how many 
devices to allocate. However, if you also specify the VOLUME parameter, the system 
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uses the greatest of the following numbers to determine how many devices and volumes to 
allocate: 


@ unit-count specified in the UNIT parameter 
@ volume-count specified in the VOLUME parameter 
@ number of serial numbers implicitly or explicitly specified 


You may also receive more devices than the unit-count requests if you specify 
VOLUME=REF or a permanently resident or reserved volume. Also, if two DD 
statements in a step request the same volume and either DD statement requests any other 
volume(s), the system assigns an additional device. 


Unit Count for Received or VOLUME =REF Data Sets: The system assigns one device 
when the DD statement receives a passed data set or refers in a VOLUME= REF 
subparameter to a cataloged data set or earlier DD statement for volume and unit 
information. Code a unit-count subparameter if the data set needs more than one device. 


Unit Count for Mass Storage Volumes: For mass storage volumes, specify a unit-count 
that is less than the volume-count in order to extend a multivolume data set to a 
non-mounted volume. If an old multivolume data set resides on a group of mass storage 
volumes, specify a unit-count equal to the number of volumes for the data set or specify P 
for parallel mount; otherwise, in a JES3 environment, the last volume containing the data 
set is left mounted exclusive to the operating system. 


Unit Count when Device Number Specified: When the first subparameter requests a 
specific device, the unit count must be | or omitted. A unit count greater than | is an 


error. 

P 
Asks the system to allocate the same number of devices as requested in the VOLUME 
volume-count or SER subparameter, whichever is higher. Thus, all volumes for the data 
set are mounted in parallel. 

DEFER 


Asks the system to assign the data set to device(s) but requests that the volume(s) not be 
mounted until the data set is opened. To defer mounting, DEFER must be specified or 
implied for all DD statements that reference the volume. 


DEFER when Data Set is Never Opened: If you request deferred mounting of a volume 
and the data set on that volume is never opened by the processing program, the volume is 
never mounted during the job step. 

Restrictions on DEFER: Do not code DEFER: 

e For a new data set on direct access. The system ignores DEFER. 

e Ona SYSCKEOV DD statement. 

e For volumes of a mass storage volume group (MSVGP) when the step contains new 


data set requests for the same mass storage volume group. The delay can cause 
volume conflicts within the job or between jobs and so cause poor performance. 
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AFF = ddname 
Requests that the system allocate different data sets residing on different, removable 
volumes to the same device during execution of the step. This request is called unit 
affinity. The ddname is the ddname of an earlier DD statement in the same step. 


Use unit affinity to reduce the number of devices used in a job step: request that an 
existing data set be assigned to the same device(s) as another existing data set. 


Restrictions on UNIT =AFF: Do not code UNIT=AFF with the following: 
e DISP=NEW if the data set referenced in the AFF subparameter is on direct access. 


e DD * or DD DATA. 
e FREE=CLOSE in the DD statement referenced in the AFF subparameter. 


Overrides 


If you code SYSOUT and UNIT on the same statement, the SYSOUT parameter overrides the 
UNIT parameter. 


The system also obtains device information when the system obtains volume serial information 


from: 

e A VOLUME=REF=dsname reference to an earlier data set. 

e A VOLUME=REF=ddname reference to an earlier DD statement. 
e The volume(s) for a passed data set. 

@ The catalog for a cataloged data set. 


However, you can override the retrieved device information if the device you specify is a subset 
of the retrieved device information. For example, if the retrieved unit grouping is 3350, and the 
specified unit subparameter is 3350A (a subset of 3350), then the system allocates from the 
devices contained in 3350A. 


Relationship to Other Parameters 


Do not code the following DD parameters with the UNIT parameter. ) 
* DYNAM 
DATA QNAME 
DDNAME 


Do not code the UNIT DEFER subparameter on a SYSCKEOV DD statement. 


UNIT = AFF and Other Parameters: Do not code DISP=NEW with UNIT =AFF=ddname if 
the referenced data set for DD statement ddname resides on a direct access device. If coded, 
the system terminates the job. If the referenced data set can be allocated to either tape or direct 
access devices, the system allocates both requests to tape devices. 


Do not code UNIT=AFF with the STORCLAS parameter. 
Do not code UNIT=AFF on a DD * or DD DATA statement or on a DD statement 


containing a SUBSYS parameter. The system ignores UNIT=AFF and defaults the device to 
SYSALLDA. 


Do not code UNIT = AFF =ddname when DD statement ddname contains FREE = CLOSE. 


10-176 MVS/XA JCL Reference 


DD: UNIT 


Location in the JCL 


When a DD statement contains a UNIT =AFF=ddname parameter, the DD statement 
referenced in the AFF subparameter must be earlier in the job step; otherwise, the system 
treats the DD statement containing UNIT=AFF as a DD DUMMY statement. For example, 
code: 


//STEP EXEC PGM=TKM 


//DD1 ODD DDNAME=DD5 

//DD2 + DD DSNAME=A , DISP=OLD 

//DD3.~+=DD DSNAME=C , DISP=SHR , UNIT=AFF=DD1 
//DD5 ~+DD DSNAME=B , DISP=SHR 


Examples of the UNIT Parameter 


//STEP2 EXEC PGM=POINT 

//DDX DD DSNAME=EST,DISP=MOD,VOLUME=SER=(42569,42570), 
Ve UNIT=(3330,2) 

//DDY DD DSNAME=ERAS,DISP=OLD,UNIT=3330-1 

//DDZ DD DSNAME=RECK,DISP=OLD, 

// VOLUME=SER=(40653,13262) , UNIT=AFF=DDX 


DD statement DDX requests two 3330 Disk Storage devices, DD statement DDZ requests the 
same two devices as DDX. Note that the operator will have to change volumes on the two 


3330 devices during execution of the job step. 


DD statement DDY requests one 3330 Disk Storage Model 11. 


//DDlL DD DSNAME=AAG3,DISP=(,KEEP), 
// VOLUME=SER=13230,UNIT=3400-5 


This DD statement defines a new data set and requests that the system assign any 3420 
Magnetic Tape Unit that can operate in 6250 BPI] NRZI nine-track format. 


//DD2 DD DSNAME=X.Y.Z,DISP=OLD,UNIT=(,2) 


This DD statement defines a cataloged data set and requests that the system assign two devices 
to the data set. The system obtains the device type from the catalog. 


//DD3 DD DSNAME=COLLECT,DISP=OLD, 
Va) VOLUME=SER=1095 , UNIT= (3330, , DEFER) 


This DD statement defines an existing data set that resides on a direct access volume and 


requests that the system assign a 3330 Disk Storage. Because DEFER is coded, the volume will 
not be mounted until the data set is opened. 


//STEPA DD DSNAME=FALL,DISP=OLD,UNIT=237 
For this data set, the system retrieves the volume and device type from the catalog. The UNIT 


parameter, by specifying device 237, overrides the catalog device type; however, device 237 
must be the same type as the device stated in the catalog. 
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VOLUME Parameter 


Parameter Type: Keyword, optional 


Note: With SMS, you do not need to use the VOLUME parameter to specify volumes for new 
data sets. See the DATACLAS parameter described on page 10-42 and the STORCLAS 
parameter described on page 10-156. 


Also with SMS, if the storage administrator has specified a system default unit, then the system 
uses the volumes associated with the default unit. In this case, you do not need to code the 
VOLUME parameter. Check with your storage administrator. 


Purpose: Use the VOLUME parameter to identify the volume or volumes on which a data set 
resides or will reside. You can request: 


A private volume 

Retention of the volume 

A specific volume by serial number 

The same volume that another data set uses 


You can also specify which volume of a multivolume data set is to be processed first and, for 
an output data set, the number of volumes required. 


A nonspecific volume request is a DD statement for a new data set that can be assigned to any 
volume or volumes. To make a nonspecific volume request for a new data set, either: 


@® Omit the VOLUME parameter. 
@® Code a VOLUME parameter but omit a SER or REF subparameter. 


Syntax: 


VOLUME |={ [PRIVATE] |,RETAIN ||, volume-sequence-number |[,volume-count] 
VOL ; ; 
SER=serial-number 
SER=(serial-number[,serial-number]...) 
REF=dsname 
REF=* .ddname 
REF=* .stepname.ddname 
REF=* .stepname.procstepname.ddname 


Single Subparameter: You can omit the parentheses if you code only PRIVATE or only a keyword 
subparameter. For example, VOLUME= PRIVATE or VOLUME=SER = 222001 or 
VOLUME=REF=DSI1. 
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Positional Subparameters: The first four subparameters are positional. The last subparameter, SER or 
REF, is a keyword subparameter and must follow all positional subparameters. Code a comma to indicate 
an omitted positional subparameter as follows: 


e If you omit PRIVATE and code RETAIN, code a comma before RETAIN. For example, 
VOLUME=(,RETAIN,?2,3,SER = (222001 ,222002,222003)). 


Code a comma when RETAIN is omitted and the volume sequence number and volume count 
subparameters follow. For example, VOLUME =(PRIVATE,,2,3,SER = (222001,222002,222003)), and 
if PRIVATE is also omitted, VOLUME =(,,2,3,SER = (222001,222002,222003)). 


Code a comma when the volume sequence number is omitted and the volume count subparameter 
follows. For example, VOLUME=(,RETAIN,,3,SER = (222001,222002,222003)), and 

VOLUME = (PRIVATE,,,3,SER = (222001,222002,222003)), and 

VOLUME = (,,,3,SER = (222001 ,222002,222003)). 


Code a comma when the volume count is omitted, at least one other subparameter precedes it, and a 
keyword subparameter follows. For example, 

VOLUME =(,RETAIN,2,,SER = (222001,222002,222003)), and 

VOLUME = (,,2,,SER = (222001 ,222002,222003)). 


Single SER Subparameter: You can omit the parentheses in the SER subparameter if you code only one 
serial number. For example, VOLUME =SER = 222001. 


Special Characters When a serial number in the SER subparameter contains special characters, other than 
hyphens, enclose it in apostrophes. For example, VOLUME = SER = (222001 ,222-02,’222/03’). 


When the dsname in the REF subparameter contains special characters, other than the periods used in a 
qualified name, enclose it in apostrophes. For example, VOLUME= REF =’DS/284’. 


Code each apostrophe that is part of the serial number or data set name as two consecutive apostrophes. 
For example, VOLUME=SER=’O” HARE’ or VOLUME= REF =’DS’371’. 


Subparameter Definition 


PRIVATE 
Requests a private volume. Private means that: 


e The system is not to allocate an output data set to the volume unless the volume is 
specifically requested, such as ina VOLUME=SER subparameter. 


e If tape, the volume is to be demounted after the data set is closed, unless RETAIN is 
also coded or the DD DISP parameter specifies PASS. 


e Ifa demountable direct access volume, the volume is to be demounted after the data 
set is closed. 


RETAIN 
For a private tape volume, RETAIN requests that this volume is not to be demounted or 
rewound after the data set is closed or at the end of the step. For a public tape volume, 
RETAIN requests that this volume is to be retained at the device if it is demounted 
during the job. 
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RETAIN Support: RETAIN is supported only for tape volumes managed by the basic 
control program and by JES2. If coded on a DD statement for a tape data set ona 
JES3-managed device, JES3 ignores the parameter when issuing KEEP/RETAIN 
messages and when performing deallocation at the end of the job. However, if RETAIN 
is coded for a tape data set on a JES3-managed device and the tape volume is to be 
shared with a later step, JES3 designates the volume as retained. 


RETAIN has no effect on the handling of direct access volumes. 


Deallocation Despite RETAIN: Coding RETAIN does not ensure that the operator will 
not unload the volume or that the system will not deallocate and demount it for another 
job. Either can occur when the device on which the volume is mounted is not allocated to 
the job step that specified RETAIN or, for unlabeled tapes, when the volume requires 
verification. 


volume-sequence-number 
Identifies the volume of an existing multivolume data set to be used to begin processing 


the data set. The volume sequence number is a decimal number from | through 255; the 
first volume is identified as 1. The volume sequence number must be less than or equal to 
the number of volumes on which the data set exists; otherwise, the job fails. 


If the volume sequence number is not specified but DCB =dsname is coded on a DD 
statement, the volume sequence number is copied from the label for the cataloged data 


set. 


For new data sets, the system ignores the volume sequence number. 


volume-count 
Specifies the maximum number of volumes that an output data set requires. The volume 
count is a decimal number from 1 through 255. The total volume count for all DD 
statements in one job step cannot exceed 4095. 


Code a volume count when a new data set will reside on 6 or more volumes. If the 

volume count is omitted or if the specified count is 1 through 5, the maximum number 

allowed is 5; if the specified count is 6 through 20, the maximum number allowed is 20: if 

the specified count is greater than 20, the maximum number allowed is a multiple of 15 

plus 5. The maximum volume count for a non-VSAM or non-SMS-managed data set is JY 
255. The maximum volume count fora VSAM or SMS-managed data set is 59. 


Volume Count and Serial Numbers: If the volume count is greater than the number of 
volume serials coded in the SER subparameter, the system assigns other volumes to the 
remaining devices. If the volume count is smaller than the number of volume serials, the 
system ignores the volume count. 


If a data set may need more volumes than the number of volume serials coded, specify a 
volume count equal to the total number of volumes that might be used. Requesting more 
volumes in the volume count will make sure that the data set can be written on more 
volumes if it exceeds the requested volumes. 


If you do not code a volume count and volume serial number(s), the system can extend an 
existing cataloged data set that resides on a removable volume up to 20 volumes. 
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Volume Count for Nonspecific Requests: If the request is for a nonspecific, public volume 
on a direct access device, the system ignores the volume count and allocates the number 
of volumes in the UNIT unit count subparameter. 


If the request is for a nonspecific, private volume, the system treats it like a specific 
request if the volume count is more than one and allocates the number of volumes in the 
volume count. 


For more information on determining the number of volumes per request, see SPL: 
System Modifications. 


SER = serial-number 

SER = (serial-number|,serial-number]...) 
For an SMS-managed data set, code the SER subparameter only if the storage 
administrator has specified GUARANTEED_SPACE= YES in the storage class of the 
data set. The volume serial numbers you specify on the VOLUME=SER parameter 
override the volume serial numbers used by SMS. The volume serial numbers must be 
assigned to the same storage group. If GUARANTEED SPACE= YES is not in effect, 
SMS ignores any volume serial numbers you specify for SMS-managed data sets. 


Identifies by serial number the volume(s) on which the data set resides or will reside. A 
volume serial number is 1 through 6 alphanumeric, national ($, #, @), or special 
characters; enclose a serial number that contains special characters, other than hyphens, 
in apostrophes. If the number is shorter than 6 characters, it is padded with trailing 
blanks. 


You can code a maximum of 255 volume serial numbers on a DD statement. 


Do not specify duplicate volume serial numbers in a SER subparameter. Each volume 
must have a unique volume serial number, regardless of whether it is a tape or disk 
volume. 


Do not code a volume serial number as SCRTCH, PRIVAT, or Lnnnnn (L with five 
numbers); these are used in messages to ask the operator to mount a volume. Do not 
code a volume serial number as MIGRAT, which is used by DFHSM for migrated data 
sets. When using some typewriter heads or printer chains, a volume serial number may be 
unrecognizable if you code certain special characters. 


For a permanently mounted direct access device, such as a 3350 Direct Access Storage, 
specifying a volume serial number and UNIT =3350 has the same result as specifying a 
device number in the UNIT parameter. 


REF = dsname 

REF =*.ddname 

REF = *.stepname.ddname 

REF = *.stepname.procstepname.ddname 
Tells the system to obtain volume serial numbers from anotker data set or an earlier DD 
statement. 


dsname 
Names a cataloged or passed data set. The system assigns this data set to the same 


volumes containing the cataloged or passed data set. 


The dsname can be an alias name or a catalog name. The dsname cannot be a 
generation data group (GDG) name or a GDG member. 
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When the dsname contains special characters, other than the periods used in a 
qualified name, enclose it in apostrophes. 


When dsname names a passed data set, it must appear on a DD statement before 
the receiving DD statement. (After a passed data set is received, the passed data set 
information is no longer available.) 


* ddname 
Asks the system to obtain the volume serial numbers from earlier DD statement 
ddname in the same job step. 


* stepname.ddname 
Asks the system to obtain the volume serial numbers from DD statement, ddname, 
in an earlier step, stepname, in the same job. 


* stepname.procstepname.ddname 
Asks the system to obtain the volume serial numbers from a DD statement in a 
cataloged or in-stream procedure. Stepname is the name of the job step that calls 
the procedure, procstepname is the name of the procedure step that contains the 
DD statement, and ddname is the name of the DD statement. 


Referenced Data Set Not Opened: When REF refers to a DD statement in a previous step 
and the data set was not opened, the system allocates a device that has the widest range 
of eligibility to meet both DD statement requests. Thus, the system might allocate a 
device for which the referring data set is not eligible. To prevent this problem for tape 
data sets, always code the DCB DEN subparameter on a DD statement that you plan to 
reference. 


References to Multivolume Tape Data Sets: When REF refers to a data set residing on 
more than one tape volume, the system allocates only the last volume. If this job step 
extends the data set to more volumes and this data set was a specific request, this new 
volume information is not available to following DD statements. 


References to Multivolume Direct Access Data Sets: When REF refers to a data set that 
resides on more than one direct access volume, the system allocates all of the volumes. 


If a DD statement that is requesting a new data set has a unit count and volume count 
greater than one but specifies no volume serial numbers, one volume is allocated. Ifa 
second DD statement within the same step requests the same data set, the same volume is 
allocated to it. If this job step extends the data set to more volumes, this new volume 
information is not available to the second DD statement. 


Two or more DD statements in the same step can request the same data set. However, if 
the data set is extended to additional volumes in that step, the additional volume 
information is not available to the second or succeeding DD statements within the step. 


References to DD Statements with UNIT Group Names: When REF refers to a DD 
Statement containing a UNIT group-name subparameter, the system allocates a device of 
the same type actually used for the referenced data set, but not necessarily a device in the 
referenced group-name. 


References to VSAM Data Sets: When REF refers to a multivolume VSAM data set, the 
system allocates a device of the same type as the first device type used for the referenced 
VSAM data set. 
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References to SMS-Managed Data Sets: When REF refers to an SMS-managed data set, 
SMS manages the new data set using the same storage class as the referenced data set. In 
this case, do not code the STORCLAS parameter on the DD statement. 


Do Not Refer to In-Stream Data Sets: Do not refer to a DD *, DD DATA, or DD 
SYSOUT statement. The system ignores the reference and defaults the device name to 


SYSALLDA, which is the group name for all direct access devices defined to the system. 


References to DUMMY Data Sets: If ddname refers to a DD DUMMY statement, the 
data set for this DD statement is also assigned a dummy status. 


Label Type Picked up from Referenced Statement: When REF is coded, the system also 
copies the LABEL label type subparameter from the referenced DD statement. 


Overrides 
The volume sequence number overrides a DISP=MOD parameter. Thus, instead of starting at 


the end of the data set on the last volume, according to the MOD subparameter, processing of 
the data set begins with the volume indicated by the volume sequence number. 


Relationship to Other Parameters 


Do not code the following parameters with the VOLUME parameter. 


BURST DDNAME MODIFY 
CHARS DYNAM QNAME 
COPIES FLASH SYSOUT 


Do not code VOLUME=REF with the STORCLAS parameter. 


Other DD Parameter Picked up from Referenced Statement: When REF is coded, the system 
also copies the LABEL label type subparameter from the referenced DD statement. 


With Mass Storage Volumes For New Data Sets: 
@ The SPACE parameter is required when VOLUME=SER Is coded. 


e To guarantee allocation of a nonspecific request to SYSGROUP, specify 
VOLUME=PRIVATE or MSVGP=SYSGROUP. 


For 3540 Diskette Input{Output Units: The VOLUME=SER, DCB=BUFNO, and DSID 


parameters on a DD * or DD DATA statement are ignored except when they are detected by a 
diskette reader as a request for an associated data set. See JBM 3540 Programmer's Reference. 


VOLUME Parameter in a JES3 System 


When you do not code a volume serial number, code PRIVATE if you want JES3 to manage 
the allocation. Otherwise, MVS manages the allocation. 


RETAIN is ignored in a JES3 system. 


Chapter 10. DD Statement 10-183 


DD: VOLUME 


VOLUME Parameter for Optical Readers 


For optical readers, if no volume serial number is specified, the system assumes J 
VOLUME=SER=OCRINP. 


VOLUME Parameter for Nonspecific Volume Requests 


A nonspecific volume request can appear on a DD statement for a new data set; the data set is 
assigned to any volume or volumes. The nonspecific request is made through a VOLUME 
parameter that does not contain a SER or REF subparameter. The parameter can contain the 
following subparameters: 


VOLUME=(PRIVATE,RETAIN, , volume-count ) 


Examples of the VOLUME Parameter 


//DD1 DD DSNAME=DATA3 ,UNIT=3340,DISP=OLD, 
// VOLUME= (PRIVATE , SER=548863) 


The DD statement requests an existing data set, which resides on the direct access volume, 
serial number 548863. Since PRIVATE is coded, the system will not assign to the volume 
another data set for which a nonspecific volume request is made and will demount the volume 
at the end of the job. 


//DD2 DD DSNAME=QUET,DISP=(MOD,KEEP) ,UNIT=(3400-5,2), 
// VOLUME=(,,,4,SER=(96341, 96342) ) 


The DD statement requests an existing data set, which resides on two volumes, serial numbers 
96341 and 96342. The VOLUME volume count subparameter requests four volumes, if 
required. Thus, if more space is required, the system can assign a third and fourth volume. 


//DD3 DD DSNAME=QOUT,UNIT=3400-5 


The DD statement defines a data set that is created and deleted in the job step. By omission of 
the VOLUME parameter, the statement makes a nonspecific volume request, thereby asking the | 
system to assign a suitable volume to the data set. 


//DD4 DD DSNAME=NEWDASD,DISP=(,CATLG,DELETE) , UNIT=3350, 
ve VOLUME=SER= 335006 , SPACE=(CYL,(10,5)) 


This new data set is assigned to volume serial number 335006, which is a permanently mounted 
volume on a particular 3350 Direct Access Storage. You can obtain the same space on the 
same volume in another way: Instead of specifying the volume serial number and UNIT = 3350, 
you can specify the device number of the particular 3350 device in the UNIT parameter. 
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//OUTDD DD DSNAME=TEST.TWO,DISP=(NEW,CATLG), 

7, VOLUME=(,,,3,SER=(333001,333002,333003)), 
// SPACE=(TRK, (9,10) ) , UNIT=(3330,P) 

//NEXT DD DSNAME=TEST.TWO,DISP=(OLD,DELETE) 


DD statement OUTDD creates a multivolume data set and catalogs it. If the data set does not 
require three volumes, it will reside on fewer volumes. DD statement NEXT then deletes the 
data set. 


If the data set resides on fewer volumes than the number of volumes on which it is cataloged, 
the following messages appear in the job log when the system deletes the data set: 


IEF285I1 TEST. TWO DELETED 
ITEF2851 VOL SER NOS=333001,333003. 

ITEF2831 TEST. TWO NOT DELETED 
IEF2831 VOL SER NOS=333002 1. 

IEF2831 TEST. TWO UNCATALOGED 


ITEF2831 VOL SER NOS=333001,333002,333003. 


If the data set resides on all specified volumes, the following messages appear in the job log 
when the system deletes the data set: 


IEF2851 TEST. TWO DELETED 
IEF2851 VOL SER NOS=333001,333002,333003. 


//SMSDS2. DD DSNAME=MYDS2.PGM,STORCLAS=SCLASO2,DISP=(NEW,KEEP) , 
// VOLUME=SER= (223344,224444) 


For a new SMS-managed data set, SMS uses the attributes in the storage class named 
SCLAS0O2 for the storage service level of the data set. Also, if the storage administrator has 
specified GUARANTEED _SPACE= YES in the storage class, VOLUME=SER can be coded 
and the data set will reside on the specified volumes. (However, if space is not available on the 
volumes, the job step fails.) Installation-written automatic class selection (ACS) routines select 
the data class and management class. 


Chapter 10. DD Statement 10-185 


10-186 MVS/XA JCL Reference 


Special DD 


Chapter 11. Special DD Statements 
Use special DD statements to specify private catalogs, private libraries, and data sets for 
storage dumps and checkpoints. 
These special statements are arranged alphabetically in the following pages. 


Syntax: 


//addname DD keyword-parameter|[,keyword-parameter]... [comments] 


Special ddnames 


The special data sets are identified by the following ddnames: 


JOBCAT 
JOBLIB 
STEPCAT 
STEPLIB 
SYSABEND 
SYSCHK 
SYSCKEOV 
SYSIN 
SYSMDUMP 
SYSUDUMP 


Code these ddnames only when you want the special data sets. 
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JOBCAT DD Statement 


Purpose: Use the JOBCAT DD statement to define a private VSAM or integrated catalog 
facility user catalog for the duration of a job. The system searches the private catalog for data 
sets before it searches the master catalog or a private catalog associated with the first qualifier 
of a data set’s name. 


Do not use the JOBCAT DD statement in a job that references an SMS-managed data set. 
SMS only accesses SMS-managed data sets that are cataloged in a system catalog. 


You cannot specify OS CVOLs as JOBCAT. Access to an OS CVOL is possible only with a 
special CVOL pointer in the master catalog. 


References: For more information on VSAM data sets, see the VSAM Administration Guide. 


Syntax: 


//JOBCAT DD DISP={OLD|SHR},DSNAME=private-catalog-name[,parameter]... [comments] J 


Parameters on JOBCAT DD Statements 


Do not specify any unit or volume information. The system obtains the location of the private 
catalog from the master catalog. Do not specify FREE=CLOSE; CLOSE is ignored. 


Relationship to STEPCAT DD Statement 


A JOBCAT DD statement applies to any job step for which you do not specify a STEPCAT 
DD statement. 


Relationship to Other Control Statements 


Concatenating Job Catalogs: To specify more than one private catalog for a job: 


e Code a JOBCAT DD statement. 


e Immediately follow this statement with DD statements that define other private catalogs. 
Omit a ddname from these subsequent DD statements. 


Location in the JCL 


e Place the JOBCAT DD statement after the JOB statement and before the first EXEC 
statement. 


e Place a JOBLIB DD statement, if coded, before a JOBCAT DD statement. 


11-2 MVS/XA JCL Reference 


JOBCAT DD 


Example of the JOBCAT DD Statement 


//EXAMPLE JOB WILLIAMS,MSGLEVEL=1 
//JOBLIB DD DSNAME=USER.LIB,DISP=SHR 
//JOBCAT DD DSNAME=LYLE,DISP=SHR 

// EXEC PGM=SCAN 


In this example, the JOBCAT DD statement specifies a private catalog. The JOBCAT DD 
statement follows the JOBLIB DD statement. 
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JOBLIB DD Statement 


Purpose: Use the JOBLIB DD statement to: 

@ Create a private library. 

e Identify a private library that the system is to search for the program named in each EXEC 
statement PGM parameter in the job. If the system does not find the program in the 


private library, only then does the system search the system libraries. 


The private library is a partitioned data set (PDS) on a direct access device. Each member is an 
executable, user-written program. 


Syntax: 


//JOBLIB DD parameter[,parameter]... [comments] 


Parameters on JOBLIB DD Statements 

When Retrieving a Cataloged Library: 

@ Code the DSNAME parameter. 

@ Code the DISP parameter. The status subparameter must be OLD or SHR. The 
disposition subparameters should indicate what you want done with the private library after 
its use in the job. 

e Do not code VOLUME or UNIT. 

When Retrieving a Library that is not Cataloged: 

@ Code the DSNAME parameter. 

e Code the DISP parameter. The DISP parameter must be DISP=(OLD,PASS) or 
DISP=(SHR,PASS). SHR indicates that the data set is old, but allows other jobs to use 
the library. 

@ Code the UNIT parameter. 

@ Code the VOLUME parameter. 

When Creating a Library: 

@ Code the DSNAME parameter to assign the library a name. 

@ Code the UNIT parameter. The library must be allocated to a direct access device. 


@e Code a VOLUME parameter, unless a nonspecific request is to be made for any volume. 


@ Code the SPACE parameter, allowing enough space for the entire library on one direct 
access volume. Specify space for the PDS directory. 
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e Code a DISP parameter. The status is NEW. Code CATLG as the disposition, if you 
intend to keep the library you are creating. Code PASS as the disposition, if you wish the 
library to be available throughout the job, but deleted at job termination. Note that you 
must code a disposition; otherwise, the system assumes DELETE and deletes the library at 
the end of the first step. 


Note: Do not use VSAM for a JOBLIB library. 
When Adding Members to the Library: 


e Inthe DSNAME parameter, follow the library name with the name of the program being 
added to the library. For example, DSNAME=LIBRARY(PROGRAM). 


® Code the status in the DISP parameter as MOD. If you cataloged the library when you 
created it, do not code a disposition. Otherwise, code PASS or CATLG. 


e Ifthe JOBLIB library is being created in the job, the JOBLIB DD DISP specified CATLG, 
and the first step adds a member to it, supply unit and volume information in the first step 
by coding: VOLUME= REF=*.JOBLIB. This parameter is needed because the library is 
not actually cataloged until the first step completes execution. Otherwise, unit and volume 
information should not be supplied for a cataloged library. 


e Do not code a SPACE parameter. The JOBLIB DD statement requests space for the entire 
library. 


Other Parameters: Code the DCB parameter if complete data control block information is not 
contained in the data set label. Do not specify FREE=CLOSE; CLOSE is ignored. 


Relationship to Other Control Statements 


Concatenating Job Libraries: To specify more than one private library for a job: 
e Code a JOBLIB DD statement. 


e Immediately follow this statement with DD statements that define other private libraries. 
Omit a ddname from these subsequent DD statements. 


The system searches the libraries for the program in the same order as the DD statements. 


Overriding a JOBLIB: If you want the system to ignore the JOBLIB for a particular job step 
and the step does not require another private library, define the system library on a STEPLIB 
DD statement. For example, specify: 


//STEPLIB DD DSNAME=SYS1.LINKLIB,DISP=SHR 
For this particular job step, the system will search SYS1.LINKLIB, as specified on the 


STEPLIB DD statement, for the program requested in the EXEC statement. The system will 
not search the JOBLIB. 
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EXEC Statement COND Parameter: If COND=ONLY is specified on the EXEC statement of 

a job step and a JOBLIB DD statement is being used, the system does not pass the unit and J 
volume information to any succeeding steps, and the system must search the catalog for the 

JOBLIB data set’s unit and volume information. 


Location in the JCL 
e The JOBLIB DD statement must immediately follow the JOB statement and any JES 
statements. There must be no intervening EXEC or other DD statements between the 


JOBLIB DD statement and the JOB statement. 


e If libraries are concatenated to the JOBLIB library, the concatenated DD statements must 
immediately follow the JOBLIB DD statement. 


e Do not include a JOBLIB DD statement in an in-stream or cataloged procedure. 


Relationship of a JOBLIB to a STEPLIB 


Use a STEPLIB DD statement to define a private library for one job step in a job. If you 
include a STEPLIB DD statement for a job step and a JOBLIB DD statement for the entire 
job, the system first searches the step library and then the system library for the requested 
program. The system ignores the job library for a step that has a STEPLIB DD statement. 


Examples of the JOBLIB DD Statement 


//PAYROLL JOB JONES,CLASS=C 

//JOBLIB DD DSNAME=PRIVATE.LIB4,DISP=(OLD, PASS) 
//STEP1 EXEC PGM=SCAN 

//STEP2 EXEC PGM=UPDATE 

//DD1 DD DSNAME=*.JOBLIB,DISP=(OLD,PASS) 


The private library requested on the JOBLIB DD statement is cataloged. The system passes 

catalog information to subsequent job steps. The system searches for the programs SCAN and 

UPDATE first in PRIVATE.LIB4, then in SYS1.LINKLIB. DD statement DD1 refers to the 

private library requested in the JOBLIB DD statement. S 


//PAYROLL JOB FOWLER,CLASS=L 
//JOBLIB DD  DSNAME=PRIV.DEPT58,DISP=(OLD,PASS), 
UNIT=3350 , VOLUME=SER=D58PVL 


//STEP EXEC PGM=DAY 

//STEP2 EXEC PGM=BENEFITS 

//DD1 DD DSNAME=*.JOBLIB, VOLUME=REF=*.JOBLIB, 
// DISP=(OLD,PASS) 


The private library requested on the JOBLIB DD statement is not cataloged; therefore, unit 
and volume information is specified. The system searches for the programs DAY and 
BENEFITS first in PRIV.DEPTS58, then in SYS1.LINKLIB. DD statement DD1 refers to the 
private library requested in the JOBLIB DD statement. 
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//TYPE JOB MSGLEVEL=(1,1) 

//JOBLIB DD DSNAME=GROUPS8.LEVEL5,DISP=(NEW,CATLG) , 
J J UNIT=3350, VOLUME=SER=148562, 

Ved SPACE=(CYL, (50,3,4)) 

//STEP1 EXEC PGM=DISC 

//DDA DD DSNAME=GROUP8.LEVEL5 (RATE) ,DISP=MOD, 
// VOLUME=REF=* . JOBLIB 

//STEP2 EXEC PGM=RATE 


The private library requested on the JOBLIB DD statement does not exist yet; therefore, the 
JOBLIB DD statement contains all the parameters required to define the library. The library is 
created in STEP1, when DD statement DDA defines the new member RATE for the library. 
Therefore, the system searches SYS1.LINKLIB for the program named DISC. In STEP2, the 
system searches for the program RATE first in GROUP8.LEVELS. 


//PAYROLL JOB BIRDSALL, TIME=1440 
//JOBLIB DD  DSNAME=KRG.LIB12,DISP=(OLD,PASS) 


Sf DD DSNAME=GROUP31.TEST,DISP=(OLD,PASS) 
// DD DSNAME=PGMSLIB,UNIT=3350, 
// DISP=(OLD,PASS) , VOLUME=SER=34568 


The three DD statements concatenate the three private libraries. The system searches the 
libraries for each program in this order: 


KRG.LIB12 
GROUP31.TEST 
PGMSLIB 
SYS1.LINKLIB 
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STEPCAT DD Statement 


Purpose: Use the STEPCAT DD statement to define a private VSAM or integrated catalog 
facility user catalog for the duration of a job step. The system searches the private catalog for 
data sets before it searches the master catalog or a private catalog associated with the first 
qualifier of a data set’s name. 


Do not use the STEPCAT DD statement in a job step that references an SMS-managed data 
set. SMS only accesses SMS-managed data sets that are cataloged in a system catalog. 


You cannot specify OS CVOLs as STEPCAT. Access to an OS CVOL its possible only with a 
special CVOL pointer in the master catalog. 


References: For more information on VSAM data sets, see VSAM Administration Guide. 


Syntax: 


//STEPCAT DD DISP={OLD]SHR},DSNAME=private-catalog-namel[,parameter]...[comments] 


Parameters on STEPCAT DD Statements 


Do not specify any unit or volume information. The system obtains the location of the private 
catalog from the master catalog. Do not specify FREE=CLOSE; CLOSE is ignored. 


Relationship to Other Control Statements “ 
Concatenating Step Catalogs: Yo specify more than one private catalog for a step: 
e Code a STEPCAT DD statement. 


e Immediately follow this statement with DD statements that define other private catalogs. 
Omit a ddname from these subsequent DD statements. 


Overriding a JOBCAT: To override a JOBCAT private catalog with the master catalog for a J 
particular job step, code the following in the job step: 


//STEPCAT DD DISP=OLD,DSNAME=master-catalog-name 


Location in the JCL 


Place a STEPCAT DD statement in any position among the DD statements for a step. 
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Example of the STEPCAT DD Statement 


EXEC PROC=SNZ12 


// 
//STEPCAT DD 


DSNAME=BETTGER, DISP=SHR 


STEPCAT DD 


The STEPCAT DD statement specifies a private catalog that the system uses for this job step 


only. 
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STEPLIB DD Statement 


Purpose: Use the STEPLIB DD statement to: 

@ Create a private library. 

e Identify a private library that the system is to search for the program named in the EXEC 
statement PGM parameter. If the system does not find the program in the private library, 


only then does the system search the system libraries. 


The private library is a partitioned data set (PDS) on a direct access device. Each member is an 
executable, user-written program. 


Subsequent job steps in the same job may refer to or receive a private library defined on a 
STEPLIB DD statement. Also, you can place a STEPLIB DD statement in an in-stream or 


cataloged procedure. 


Syntax: 


//STEPLIB DD parameter[,parameter]... [comments] 


Parameters on STEPLIB DD Statements 
When Retrieving a Cataloged Library: 
@ Code the DSNAME parameter. 


@ Code the DISP parameter. The status subparameter must be OLD or SHR. The 
disposition subparameters should indicate what you want done with the private library after 
its use in the job step. 


e Do not code VOLUME or UNIT. 


When Retrieving a Library Passed from a Previous Step: In the passing job step, code a DISP 
disposition subparameter of PASS when a step library is to be used by subsequent steps in the 
job. 


In a receiving step: 


e Code in the DSNAME parameter either the name of the step library or a backward 
reference of the form *.stepname.STEPLIB. If the step library is defined in a procedure, 
the backward reference must include the procedure step name: 

* stepname.procstepname.STEPLIB. 


e Code the DISP parameter. The status subparameter must be OLD. The disposition 


subparameters should indicate what you want done with the private library after its use in 
the receiving step. 
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When Retrieving a Library that is Neither Cataloged Nor Passed: 


Code the DSNAME parameter. 

Code the DISP parameter. The status subparameter must be OLD or SHR. The 
disposition subparameters should indicate what you want done with the private library after 
its use in the job step. 


Code the UNIT parameter. 


Code the VOLUME parameter. 


When Creating a Library: 


Code the DSNAME parameter to assign the library a name. 
Code the UNIT parameter. The library must be allocated to a direct access device. 
Code a VOLUME parameter, unless a nonspecific request is to be made for any volume. 


Code the SPACE parameter, allowing enough space for the entire library on one direct 
access volume. Specify space for the PDS directory. 


Code a DISP parameter. The status is NEW. Code CATLG as the disposition, if you 
intend to keep the library you are creating. Code PASS as the disposition, if you wish the 
library to be available to a following step. Note that you must code a disposition; 
otherwise, the system assumes DELETE and deletes the library at the end of the step. 


Note: Do not use VSAM for a STEPLIB library. 


When Adding Members to the Library: 


In the DSNAME parameter, follow the library name with the name of the program being 
added to the library. For example, DSNAME=LIBRARY(PROGRAM). 


Code the status in the DISP parameter as MOD. If the library is cataloged, do not code a 
disposition. Otherwise, code PASS or CATLG. 


If the library is cataloged, do not code unit and volume information. Otherwise, code 
UNIT and VOLUME. 


Do not code a SPACE parameter. The STEPLIB DD statement requests space for the 
entire library. 


Other Parameters: Code the DCB parameter if complete data control block information is not 
contained in the data set label. Do not specify FREE=CLOSE; CLOSE is ignored. 
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Relationship to Other Control Statements . 
Concatenating Step Libraries: To specify more than one private library for a step: 
e Code a STEPLIB DD statement. 


e Immediately follow this statement with DD statements that define other private libraries. 
Omit a ddname from these subsequent DD statements. 


The system searches the libraries for the program in the same order as the DD statements. 


Overriding a JOBLIB: If you want the system to ignore the JOBLIB for a particular job step 
and the step does not require another private library, define the system library on a STEPLIB 
DD statement. For example, specify: 


//STEPLIB DD DSNAME=SYS1.LINKLIB,DISP=SHR 


For this particular job step, the system will first search SYS1.LINKLIB, as specified on the ) 
STEPLIB DD statement, for the program requested in the EXEC statement. The system will 
not search the JOBLIB. 


Location in the JCL 
Place a STEPLIB DD statement in any position among the DD statements for a step. 


If libraries are concatenated to the STEPLIB library, the concatenated DD statements must . 
immediately follow the STEPLIB DD statement. ) 


Relationship of a STEPLIB to a JOBLIB 


Use a JOBLIB DD statement to define a private library that the system is to use for an entire 
job. If you include a JOBLIB DD statement for the job and a STEPLIB DD statement for an 
individual job step, the system first searches the step library and then the system library for the 
program requested in the EXEC statement. The system ignores the JOBLIB library for that 
step. 
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C Examples of the STEPLIB DD Statement 


//PAYROLL JOB BROWN,MSGLEVEL=1 

//STEP1 EXEC PROC=LAB14 

//STEP2 EXEC PGM=SPKCH 

//STEPLIB DD DSNAME=PRIV.LIB5,DISP=(OLD, KEEP) 
//STEP3 EXEC PGM=TIL80 

//STEPLIB DD DSNAME=PRIV.LIB12,DISP=(OLD,KEEP) 


The system searches PRIV.LIBS for the program SPKCH and PRIV.LIB12 for TIL80. The 
system catalogs both private libraries. 


//PAYROLL JOB BAKER,MSGLEVEL=1 
//JOBLIB DD DSNAME=LIB5.GROUP4,DISP=(OLD,PASS) 
//STEP1 EXEC PROC=SNZ12 
//STEP2 EXEC PGM=SNAP10 
//STEPLIB DD DSNAME=LIBRARYP,DISP=(OLD,PASS), 
‘ // UNIT=3350, VOLUME=SER=55566 
//STEP3 EXEC PGM=A1530 
//STEP4 EXEC PGM=SNAP11 
//STEPLIB DD DSNAME=*.STEP2.STEPLIB, 
// DISP=(OLD,KEEP) 


The system searches LIBRARYP for program SNAP10; LIBRARYP is passed to subsequent 
steps of this job. The STEPLIB DD statement in STEP4 refers to the LIBRARYP library 
defined in STEP2; the system searches LIBRARYP for SNAP11. Since a JOBLIB DD 
statement is included, the system searches for programs SNZ12 and A1530 first in 

c LIBS.GROUP4, then in SYS1.LINKLIB. 


//PAYROLL JOB THORNTON ,MSGLEVEL=1 

//JOBLIB DD DSNAME=LIB5.GROUP4,DISP=(OLD,PASS) 
//STEP1 EXEC PGM=SUM 

//STEPLIB DD DSNAME=SYS1.LINKLIB,DISP=OLD 
//STEP2 EXEC PGM=VARY 

//STEP3 EXEC PGM=CALC 

//STEPLIB DD DSNAME=PRIV.WORK,DISP=(OLD, PASS) 


// DD DSNAME=LIBRARYA,DISP=(OLD,KEEP) , 
vy, UNIT=3350, VOLUME=SER=44455 

if, DD DSNAME=LIB.DEPT88 ,DISP=(OLD, KEEP) 
//STEP4 EXEC PGM=SHORE 


For STEP2 and STEP4, the system searches the private library named LIB5.GROUP4 defined 
in the JOBLIB DD statement first for programs VARY and SHORE. For STEP1, the system 
searches SYS1.LINKLIB first for program SUM, because the STEPLIB DD statement names 
the system library. 


A concatenation of private libraries is defined in STEP3. The system searches for the program 
named CALC in this order: PRIV.WORK, LIBRARYA, LIB.DEPT88, SYSI.LINKLIB. Ifa 
later job step refers to the STEPLIB DD statement in STEP3, the system will search for the 
program in the private library named PRIV.WORK and, if it is not found there, in 
SYS1.LINKLIB; the concatenated libraries are not searched. 
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SYSABEND, SYSMDUMBP, and SYSUDUMP DD Statements 


Purpose: Use a SYSABEND, SYSMDUMP, or SYSUDUMP DD statement in a job step to 
direct the system to produce a dump. The system produces the requested dump: 


e If the step terminates abnormally. 
e If the step starts to terminate abnormally, but system recovery procedures enable the step 
to terminate normally. 


The dump DD statements for requesting dumps are: 


SYSABEND DD statement 
Produces a dump of user and system areas; this dump contains all the areas dumped in a 
SYSUDUMP plus the local system queue area (LSQA), including subpools 229 and 230, 
and the input/output system (IOS) control blocks for the failing task. The dump is 
formatted, so that it can be printed directly. 


SYSMDUMP DD statement 
Produces a dump of the system areas and the program’s address space. The dump is 
unformatted and machine-readable; to be used, it must be printed by the PRDUMP 
service aid or by the interactive problem control system (IPCS). 


SYSUDUMP DD statement 
Produces a dump of user areas. The dump is formatted, so that it can be printed directly. 


The dump contents are as described only when the installation uses the IBM-supplied defaults 
for the dumps. The contents of these dumps can be set during system initialization and/or can 
be changed for an individual dump in the ABEND macro instruction, in a CHNGDUMP 
command, and by a SLIP command. For details, see SPL: Initialization and Tuning. 


Dumps are optional; use a dump DD statement only when you want to produce a dump. 


References: For information on how to interpret dumps, see Debugging Handbook and 
Diagnostic Techniques. 


Syntax: 


//SYSABEND DD parameter[,parameter]... [comments] 


//SYSMDUMP DD parameter[,parameter]... [comments] 
//SYSUDUMP DD parameter[,parameter]... [comments] 


Location in the JCL 


Do not place in the same job step two DD statements with the same dump ddname. 
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Storing a Dump 


S If you wish to store a dump instead of having it printed, code the following parameters on the 
dump DD statement: 


@e The DSNAME parameter. 
@e The UNIT parameter. 
e The VOLUME parameter. 


e The DISP parameter. The data set’s status is NEW. Because you want to store the data 
set, make the data set’s abnormal termination disposition KEEP or CATLG. 


@e The SPACE parameter, if the dump is written on direct access. 
| Note: Do not use VSAM for dump data sets. 


| SYSMDUMP Requirements: The SYSMDUMP DD statement must specify a magnetic tape 
| unit or a direct access device. 


To write more than one SYSMDUMP dump in the same data set on tape, specify the 
following: 


e DSNAME=SYSI1.SYSMDPxx where xx is 00 through FF. SYSMDPxx is a preallocated 
data set that you must initialize with an end-of-file (EOF) mark on the first record. 


eS e DISP=SHR 


You can ask the system to write additional dumps only if you off-load any previous dump and 
write an EOF mark at the beginning of the SYS1.SYSMDPxx data set. To accomplish this, 
your installation must install an exit routine for message IEA993. For information on this exit 
routine, see SPL: User Exits. 


Printing a Dump 


cC To print a dump for either a SYSABEND or SYSUDUMP DD statement, code one of the 
following on the DD statement for the output data set: 


e <A UNIT parameter that specifies a printer. 
@e The SYSOUT parameter that specifies a print output class. 


To print a dump fora SYSMDUMP DD statement, use one of the following programs: 


PRDMP service aid 
This program is described in SPL: Service Aids. When using PRDMP, the SYSMDUMP 
DD statement must allocate the dump data set to a magnetic tape or a direct access 
device. 


IPCS 


This program is described in Interactive Problem Control System (IPCS) User's Guide and 
: Reference. When using IPCS, the data set disposition affects the collection of events. 
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If you print the dump in a JES3 system on a 3800 Printing Subsystem, code CHARS = DUMP 
for a dump with 204 characters per line and FCB=STD3 for 8 lines per inch. ) 


Overriding Dump DD Statements 
To change the type of dump requested in a dump DD statement in a cataloged or in-stream 


procedure, the ddname of the overriding DD statement in the calling step must be different 
from the dump ddname of the procedure DD statement. 


Duplicate Dump Requests 
You can code more than one dump request in a job step using DD statements that have 
different ddnames. When you do this, the system uses the last dump DD statement it 
encounters. 
When the system finds dump DD statements with duplicate ddnames, processing is as follows: ; 
e Ina JES2 system, the job fails with message IEA912I. 
e Ina JES3 system: 


— If both DD statements request JES3- or jointly-managed devices, the job is cancelled 
during JES3 interpretation. 


— If only one or neither statement requests JES3- or jointly-managed devices, the job fails 
with message [EA912I. 


Examples of the SYSABEND, SYSMDUMP, and SYSUDUMP DD Statements 


//STEP2 EXEC PGM=A 
//SYSUDUMP DD SYSOUT=A 


The SYSUDUMP DD statement specifies that you want the dump routed to system output 


class A. | } 


//SYSMDUMP DD DSNAME=DUMP ,DISP=(NEW,KEEP) , 
// UNIT=3400-6 , VOLUME=SER=147958 


The SYSMDUMP DD statement specifies that the dump is to be stored on a tape. Because the 
LABEL parameter is not coded, the tape must have IBM standard labels. 


//STEP1 EXEC PGM=PROGRAM1 

//SYSABEND DD DSNAME=DUMP,UNIT=3350,DISP=(,PASS,KEEP), 

// VOLUME=SER=1234,SPACE=(TRK, (49,20) ) 

//STEP2 EXEC PGM=PROGRAM2 

//SYSABEND DD DSNAME=*.STEP1.SYSABEND,DISP=(OLD,DELETE , KEEP) 
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Both SYSABEND DD statements specify that the dump is to be stored. The space request in 
STEP1 is ample and will not inhibit dumping due to insufficient space. If STEP1 does not 
abnormally terminate but STEP2 does, the system writes the dump for STEP2 in the space 
allocated in STEP1. In both steps, an abnormal termination disposition of KEEP is specified 
so that the dump is stored if either of the steps abnormally terminates. If both of the steps 
successfully execute, the second DISP subparameter, DELETE, in STEP2 instructs the system 
to delete the data set and free the space acquired for dumping. 


//STEP1 EXEC PGM=WWK 
//SYSMDUMP DD DSNAME=DUMP,UNIT=3350,DISP=(,DELETE, 


Tif KEEP ) , VOLUME=SER=5 4366 , SPACE= (1680, (160,80) ) 
/ /STEP2 EXEC PGM=IKJEFTO1,PARM=AMDPRDMP , COND=ONLY 

//IN DD DSNAME=*.STEP1.SYSUDUMP,DISP=(OLD,DELETE) , 
// VOLUME=REF=* .STEP1.SYSUDUMP 


STEP! specifies that the dump is to be stored on a direct access device if the step abnormally 
terminates. Because the EXEC COND=ONLY parameter is specified in STEP2, STEP2 is 
executed only if STEP1 abnormally terminates. STEP2 executes the PRDMP service aid to 
print the dump. 


//STEP EXEC PGM=EXSYSM 
//SYSMDUMP DD  UNIT=3330,VOLUME=SER=123456,SPACE=(CYL,(0,1)), 
Ves DISP=(NEW, DELETE ,KEEP) , DSNAME=MDUMP 


The SYSMDUMP DD statement allocates dump data set MDUMP to a direct access device. 


//STEP EXEC PGM=EXSYSMDP 
//SYSMDUMP DD DSNAME=SYS1.SYSMDP00,DISP=SHR 


The SYSMDUMP is written in data set SYSI.SYSMDP00. 


Note: When you specify a DSNAME of SYS1.SYSMDPxx and DISP=SHR, the first 
SYSMDUMP produced is retained on the data set. This first SYSMDUMP must be off-loaded 
and an end-of-file mark written at the beginning of the SYS1.SYSMDPxx data set before 
subsequent dumps can be written. 


//STEPA EXEC PGM=EXSYSM2 , ADDRSPC=REAL 
//SYSMDUMP DD UNIT=SYSDA,SPACE=(CYL,(0,1)), 
// DISP=(NEW, PASS) 
//STEP2 EXEC PGM=IKJEFTO1,PARM=AMDPRDMP , COND=ONLY 
//SYSUT1 DD DSNAME=*.STEPA.SYSMDUMP , DISP=OLD 
//PRINTER DD SYSOUT=A 
//SYSIN DD - 
FORMAT 
LOGDATA 
END 


Jt 


In STEPA, the SYSMDUMP DD statement directs output to a VIO data set (1) by specifying a 
VIO-eligible device group (SYSDA) and (2) by not assigning a data set name to make the data 
set temporary and eligible for VIO. STEPB is executed only if STEPA abnormally terminates. 
In STEPB, the dump output is printed by the PRDMP service aid on a device assigned to 
output class A. 
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SYSCHK DD Statement 


Purpose: Use the SYSCHK DD statement to define a checkpoint data set that the system is to 
write during execution of a processing program. Use this statement again when the step is 
restarted from a checkpoint written in the data set. 


Note: If restart is to begin at a step, as indicated by the RD parameter on the EXEC 
statement, do not use a SYSCHK DD statement. 


References For detailed information about the checkpoint/restart facilities, see 
Checkpoint/Restart User's Guide. 


Syntax: 


//SYSCHK DD parameter[,parameter]... [comments] 


Parameters on SYSCHK DD Statements 
When Creating a Checkpoint Data Set: 
® Code a SPACE parameter, but do not request secondary space. 


— The primary space request must be large enough to hold all checkpoints. Although 
your program or the system can write checkpoints in secondary space, the system ) 
cannot perform a restart from checkpoints in secondary space. 


— If you do not request secondary space and the primary space fills up, the job 
abnormally terminates. You can successfully restart the job at the last checkpoint; 
however, when the processing program or system writes the next checkpoint the job 
abnormally terminates again. 


— If you do request secondary space and the primary space fills up, the processing 
program or the system writes one invalid checkpoint followed by successful 
checkpoints. An attempt to restart from one of the checkpoints following the invalid S 
checkpoint results in abnormal termination. 


@ Code the RLSE subparameter of the SPACE parameter only if the processing program 
opens the checkpoint data set and the checkpoint data set remains open until the end of the 
program. If you specify RLSE, the system releases unused space after the first CLOSE 
macro instruction. 


Do not code the RLSE subparameter: 


— If the processing program opens the checkpoint data set before writing each checkpoint 
and closes the checkpoint data set after writing each checkpoint. The system releases 
all unused space while closing the data set after the first checkpoint, leaving no space 
for additional checkpoints. 


— Ifthe system opens the checkpoint data set. The system opens and closes the 
checkpoint data set before it writes the first checkpoint. With RLSE specified, the 
system would release all space before the first checkpoint could be written. 


11-18 MVS/XA JCL Reference 


SYSCHK DD 


e Code the CONTIG subparameter of the SPACE parameter to request contiguous space. 
The system otherwise provides additional primary space using extents. If the extents are 
not contiguous, any checkpoints in these extents cannot be used for a successful restart. 

When Retrieving a Cataloged Checkpoint Data Set: 

e Code the DSNAME parameter. 

@ Code the DISP parameter to specify a status of OLD and a disposition of KEEP. 

e Code the VOLUME parameter. If the checkpoint entry is on a tape volume other than the 
first volume of the checkpoint data set, code the volume serial number or volume sequence 
number to identify the correct volume. The serial number of the volume on which a 
checkpoint entry was written appears in the console message issued after the checkpoint 


entry is written. 


e Code the UNIT parameter, if you coded the VOLUME parameter, because the system will 
not look in the catalog for unit information. 


When Retrieving a Checkpoint Data Set that is not Cataloged: 


@e Code the DSNAME parameter. If the checkpoint data set is partitioned, do not code a 
member-name in the DSNAME parameter. 


@ Code the DISP parameter to specify a status of OLD and a disposition of KEEP. 

@e Code the VOLUME parameter. The serial number of the volume on which a checkpoint 
entry was written appears in the console message issued after the checkpoint entry is 
written. 

@ Code the UNIT parameter. 

Other Parameters: 


@ Code the LABEL parameter if the checkpoint data set does not have standard labels. 


e Code DCB=TRTCH =C if the checkpoint data set is on 7-track magnetic tape with 
nonstandard labels or no labels. 


e Ifthe volume containing the checkpoint data set is to be mounted on a JES3-managed 
device, do not code the DEFER subparameter of the UNIT parameter on the SYSCHK 
DD statement. 


Note: Do not use VSAM for checkpoint data sets. 


Relationship to Other Control Statements 


Code the RESTART parameter on the JOB statement; without it, the system ignores the 
SYSCHK DD statement. 
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Location in the JCL 


@e When writing checkpoints, place the SYSCHK DD statement after any JOBLIB DD 
statements, if coded; otherwise, after the JOB statement. 


@ When restarting a job from a checkpoint, place the SYSCHK DD statement immediately 
before the first EXEC statement of the resubmitted job. 


Examples of the SYSCHK DD Statement 


//TOB1 JOB RESTART=(STEP3,CK3) 
//SYSCHK DD DSNAME=CHLIB,UNIT=3350, 

// DISP=OLD , VOLUME=SER=456789 
//STEP1 EXEC PGM=A 


The checkpoint data set defined on the SYSCHK DD statement is not cataloged. 


/ { JOB2 JOB RESTART=(STEP2,NOTE2) 

//JOBLIB DD DSNAME=PRIV.LIB3,DISP=(OLD,PASS) 
//SYSCHK DD DSNAME=CHECKPTS , DISP=(OLD,KEEP) , 
// UNIT=3400-6 , VOLUME=SER=4 38291 
//STEP1 EXEC PGM=B 


The checkpoint data set defined on the SYSCHK DD statement is not cataloged. Note that the 
SYSCHK DD statement follows the JOBLIB DD statement. 
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SYSCKEOV DD Statement 


Purpose: Use the SYSCKEOV DD statement to define a checkpoint data set for checkpoint 
records from the checkpoint at end-of-volume (EOV) facility. The checkpoint at EOV facility is 
invoked by a DD CHKPT parameter. 


References: For information on the DD CHKPT parameter, see “CHKPT Parameter” on 
page 10-31. For information on checkpoint/restart facilities, see Checkpoint/Restart User's 
Guide. 


Syntax: 


//SYSCKEOV DD parameter[,parameter]... [comments] 


Parameters on SYSCKEOV DD Statements 


When Creating a Checkpoint Data Set: 


Code a SPACE parameter, but do not request secondary space. The primary space request 
must be large enough to hold all checkpoints; if not, the job abnormally terminates. 


Do not code the RLSE subparameter of the SPACE parameter. 


Code the CONTIG subparameter of the SPACE parameter to request contiguous space. 
The system otherwise provides additional primary space using extents. 


The SYSCKEOV DD statement must define a BSAM data set. 


Code DISP = MOD to reduce loss of checkpoint data in case of a system failure during 
checkpointing. 


Other Parameters: 


Do not code on the SYSCKEOV DD statement the following: 

— CHKPT=EOV parameter. 

— DCB parameter. All DCB information is provided by the checkpoint at EOV facility. 
— DEFER subparameter of the UNIT parameter. 


If you code the LABEL parameter, you must specify LABEL=(,SL) for IBM standard 
labels. 


If the SYSCKEOV data set resides on a direct access storage device, that device cannot be 
shared with another processor. 
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Location in the JCL 


If you code a CHKPT parameter on any DD statements in a job step, place a SYSCKEOV DD 
statement in the DD statements for the step. 


Example of the SYSCKEOV DD Statement 


//SYSCKEOV DD DSNAME=CKPTDS , UNIT=TAPE , DISP=MOD 


This statement defines a checkpoint data set for checkpoint at EOV records. 
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SYSIN DD Statement 


Purpose: Use a SYSIN DD statement to begin an in-stream data set. In-stream data sets 
begin with a DD * or DD DATA statement; these DD statements can have any valid ddname, 
including SYSIN. If you omit a DD statement before input data, the system provides a DD * 
statement with the ddname of SYSIN. 


Syntax: 


//SYSIN DD parameter[,parameter]... [comments] 


Parameters on SYSIN DD Statements 


The first parameter is an * or DATA, to signal that an in-stream data set follows immediately. 


Location in the JCL 


A SYSIN DD statement appears at the beginning of an in-stream data set. 


Examples of SYSIN DD Statements 


//STEP1 EXEC PGM=READ 


//SYSIN DD * 

data 
//OUT1 DD SYSOUT=A 
//STEP2 EXEC PGM=WRITE 
//SYSIN DD DATA , DLM=17 
17 
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Chapter 12. Delimiter Statement 


Purpose: Use the delimiter statement to indicate the end of data or transmittal records in the 
input stream. 


Syntax: 


/* [comments] 
xx [comments ] 


A delimiter statement consists of the characters /* or the two characters specified in a DLM 
parameter in columns 1 and 2 and one field: comments. 


Do not continue a delimiter statement. 


Comments Field 
The comments field follows the delimiter characters. 


For JES2, code any comments in columns 4 through 80. (A blank must follow the delimiter 
characters.) 


For JES3, code any comments in columns 3 through 80. 


Relationship to the DLM Parameter 
The system recognizes a delimiter other than /* if a DLM parameter is coded on: 
e The DD * or DD DATA statement that defines an in-stream data set. 


e The XMIT JCL statement that precedes input stream records to be transmitted to another 
node. 


e The JES2 /*XMIT statement that precedes input stream records to be transmitted to 
another node. 


A delimiter statement is optional: 


e If the data is preceded by a DD * statement without a DLM parameter. 
e If transmitted records are preceded by an /*XMIT statement without a DLM parameter. 
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Delimiter Statement 


A delimiter statement must appear: 


e At the end of an in-stream data set that begins with a DD DATA statement. 


e At the end of an in-stream data set that begins with a DD statement containing a DLM 


parameter. 


e At the end of records to be transmitted to another node when the records are preceded by 
an /*XMIT statement containing a DLM parameter. 


e At the end of records to be transmitted to another node when the records are preceded by 


an XMIT JCL statement. 


//JOB54 
//STEPA 
//DD1 


f= 


//DD2 


AA 


//3OB54 


// 
//3OB55 
//STEPA 
//DD1 


j/* 


//DD2 


Examples of the Delimiter Statement 


JOB ,'C BROWN' ,MSGLEVEL=(2,0) 
EXEC PGM=SERS 

DD * 

data 

END OF DATA FOR DATA SET DD1 
DD DATA, DLM=AA 

data 


END OF DATA FOR DATA SET DD2 


JOB ,'C BROWN' ,MSGLEVEL=(2,0) 
XMIT DEST=NODEA,DLM=BB 

JOB ,'C BROWN' ,MSGLEVEL=(2,0) 
EXEC PGM=SERS 

DD * 

data 

END OF DATA FOR DATA SET DD1 
DD DATA , DLM=AA 

data 


END OF DATA FOR DATA SET DD2 
END OF TRANSMITTED JOB 


This example shows nested delimiter statements. 
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Chapter 13. ENDCNTL Statement 


Purpose: Use the ENDCNTL statement to mark the end of the program control statements 
following a CNTL statement. 


Syntax: 


//(label] ENDCNTL [comments] 


The ENDCNTL statement consists of the characters // in columns 1 and 2 and three fields: 
label, operation (ENDCNTL), and comments. 


Label Field 
Code a label on the ENDCNTL statement, as follows: 


Each label must be unique within the job. 

The label must begin in column 3. 

The label is | through 8 alphanumeric or national ($, #, @) characters. 
The first character must be alphabetic or national ($, #, @) 

The label must be followed by at least one blank. 


Operation Field 


The operation field consists of the characters ENDCNTL and must be preceded and followed 
by at least one blank. It can begin in any column. 


Comments Field 


The comments field follows the ENDCNTL after at least one intervening blank. 


Location in the JCL 


The ENDCNTL statement immediately follows the one or more program control statements 
following a CNTL statement. Thus, the ENDCNTL statement can appear in a job step or ina 
cataloged or in-stream procedure. 
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Example of the ENDCNTL Statement 


//STEP1 EXEC PGM=PRINT 

//ABLE CNTL 

//STATE1 PRINTDEV BUFNO=20,PIMSG=YES , DATACK=BLOCK 
//BAKER ENDCNTL 


/ /CALLER DD UNIT=3800-3,CNTL=* .ABLE 
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Chapter 14. EXEC Statement 


Purpose: Use the EXEC (execute) statement to identify the program or cataloged or in-stream 
procedure that this job step is to execute and to tell the system how to process the job step. 
The EXEC statement marks the beginning of each step in a job or a procedure. 


A job can have a maximum of 255 job steps. This maximum includes all steps in any 
procedures the EXEC statements call. 


The parameters you can specify for step processing are arranged alphabetically in the following 
pages. 


References: For information about the JES initialization parameters that provide installation 
defaults, see SPL: JES2 Initialization and Tuning and SPL: JES3 Initialization and Tuning. 


Syntax: 


//(stepname] EXEC positional-parameter[,keyword-parameter]...[comments] 


The EXEC statement consists of the characters // in columns | and 2 and four fields: name, 
operation (EXEC), parameter, and comments. 


An EXEC statement is required for each job step. 


Name Field 


A stepname is optional, but is needed for the following. When a stepname is needed, it must be 
unique within the job, including stepnames in any procedures called by the job. 


e Referring to the step in later job control statements. 


e Overriding parameters on an EXEC statement or DD statement in a cataloged or in-stream 
procedure step. 


e Adding DD statements to a cataloged or in-stream procedure step. However, a stepname is 
not required when adding to the first step in a procedure. 


e Performing a step or checkpoint restart at or in the step. 


e Identifying a step in a cataloged or in-stream procedure. 
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Code a stepname as follows: 


The stepname must begin in column 3. 


Operation Field 


The stepname is 1 through 8 alphanumeric or national ($, #, @) characters. 
The first character must be alphabetic or national ($, #, @). 
The stepname must be followed by at least one blank. 


The operation field consists of the characters EXEC and must be preceded and followed by at 
least one blank. It can begin in any column. 


Parameter Field 


An EXEC statement has two kinds of parameters: positional and keyword. 


Do not use EXEC statement parameter keywords as symbolic parameters, names, or labels. 


Positional Parameters: An EXEC statement must contain one of the positional parameters: 
PGM, PROC, or procedure name. This positional parameter must precede all keyword 


parameters. 


POSITIONAL PARAMETERS VALUES PURPOSE 


program-name 
* stepname.ddname 

* stepname.procstepname.ddname 
JCLTEST 

JSTTEST 


See page 14-23 


PROC = procedure-name 
procedure-name 


See page 14-25 


program-name: 1 - 8 alphanumeric or 
$, #, @ characters 
ddname: name of DD for PDS 
member containing program 
stepname: DD in named step 
procstepname: step in named procedure 


JCLTEST and JSTTEST: scan for syntax 
without executing the job (JES3 only) 


procedure-name: 1 - 8 alphanumeric or 
$, #, @ characters 


Names the program the system is 
to execute or, for JES3 only, 
requests syntax check without 
execution. 


Names the cataloged or in-stream 
procedure the system is to call 
and execute. 


Keyword Parameters: An EXEC statement can contain the following keyword parameters. 
You can code any of the keyword parameters in any order in the parameter field after the 


positional parameter. 


KEYWORD PARAMETERS VALUES PURPOSE 


ACCT[.procstepname] = (accounting-information) 


See page 14-5 


ADDRSPC[.procstepname] = | VIRT 
REAL 


See page 14-7 
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accounting-information: up to 142 characters 
[.procstepname]: name of procedure EXEC 
containing ACCT to be affected 


VIRT: virtual (pageable) storage 

REAL: real (nonpageable) storage 

[.procstepname]: name of procedure EXEC 
containing ADDRSPC to be affected 


Specifies accounting information 
for the step. 


Indicates the type of storage 
required for the step. 


EXEC 


KEYWORD PARAMETERS VALUES PURPOSE 


COND[.procstepname] = 


(code,operator[,stepname][.procstepname]) 
[,(code,operator[,stepname][.procstepname))...] 


code: 0 - 4095 Specifies the return code tests used 

operator: GT Code from to determine if this step is to be 
GE chart on executed or bypassed. 

page 14-13 


EVEN 
,ONLY 


EVEN: execute step even if preceding step 
abnormally terminated 

ONLY: execute step only if preceding step 
abnormally terminated 

stepname: step issuing return code 

procstepname: step is in named procedure 


[.procstepname]: name of procedure EXEC 
containing COND to be affected 


See page 14-9 


DPRTY[.procstepname] = ([value1 ][, value2]) valuel: 0 - 15 

value2: 0 - 15 

[.procstepname]: name of procedure EXEC 
containing DPRTY to be affected 


Assigns a dispatching priority for 
the address space: dispatching 
priority = (valuel * 16) + value2 


See page 14-15 


n: 0 - 3273 minus number of DD statements Holds a number of data set 
in step allocations for reuse. 

[.procstepname]: name of procedure EXEC 
containing DYNAMNBR to be affected 


DYNAMNBR[-procstepname]=n 


See page 14-17 


PARM[.procstepname] = information information: up to 100 characters Passes variable information to the 
[.procstepname]: name of procedure EXEC processing program. 

containing PARM to be affected 
See page 14-19 


PERFORM|[.procstepname]=n n: 1 - 999 Specifies the step’s performance 
[.procstepname]: name of procedure EXEC group, which determines the rate 
containing PERFORM to be affected at which the step has access to the 
processor, storage, and channels. 


See page 14-21 


RD[.procstepname]= | R R: restart, checkpoints allowed Indicates whether the operator 
RNC RNC: restart, no checkpoints should perform automatic step 
NR NR: no restart, checkpoints allowed restart, if the step fails, and 
NC NC: no restart, no checkpoints controls whether checkpoints are 
[.procstepname]: name of procedure EXEC written for CHKPT macros or 
containing RD to be affected DD statement CHKPT 
parameters. 


See page 14-26 


REGION|[.procstepname] = Ree | valueK: even number, | - 7 digits Specifies the amount of space in 


valueM from | - 2096128 kilobytes or megabytes required 
valueM: even or odd number, | - 4 digits by the step. 

from 1 - 2047 
[-procstepname]: name of procedure EXEC 

containing REGION to be affected 


See page 14-30 


TIME[.procstepname] = | ({minutes][,seconds]) minutes: 1 - 1439 Specifies the maximum time the 
1440 seconds: 1 - 59 step is to use the processor and 
[.procstepname]: name of procedure EXEC requests messages giving the time 
containing TIME to be affected used. 


See page 14-33 
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Keyword Parameters on EXEC Statement that Calls a Procedure: When the EXEC statement 
positional parameter calls a cataloged or in-stream procedure, all of the EXEC statement’s 
keyword parameters override matching EXEC keyword parameters in the called procedure. Ifa 
keyword parameter is to override a parameter on only one EXEC statement in the procedure, 
code .procstepname immediately following the keyword: 


keyword.procstepname=value 


The procstepname is the name field on the procedure EXEC statement containing the keyword 
parameter to be overridden. For example: 


//STEP1L EXEC PROC=WKREPORT ,ACCT.PSTEPWED=5670 


The accounting information 5670 applies only to step PSTEPWED in the procedure 
WKREPORT. 


Comments Field 


The comments field follows the parameter field after at least one intervening blank. 


Location in the JCL 


An EXEC statement must be the first statement in each job step or cataloged or in-stream 
procedure step. 


Examples of EXEC Statements 


//STEP4 EXEC PGM=DREC,PARM='3018,NO' 


The EXEC statement named STEP4 invokes a program named DREC and passes the value in 
the PARM parameter to DREC. 


df EXEC PGM=ENTRY , TIME=(2,30) 


This EXEC statement, which does not have a stepname, invokes a program named ENTRY 
and specifies the maximum processor time for execution of the step. 


//FOR EXEC PROC=PROC489,ACCT=DB1528,RD.PSTEP2=RNC , DEV=3350 


The EXEC statement named FOR invokes a cataloged or in-stream procedure named 
PROC489. The ACCT parameter applies to all steps in the procedure. The RD parameter 
applies to only the step named PSTEP2. The DEV parameter assigns the value 3350 to the 
symbolic parameter &DEV in a procedure statement. 
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ACCT Parameter 


Parameter Type: Keyword, optional 
Purpose: Use the ACCT parameter to specify one or more subparameters of accounting 
information that apply to this step. The system passes the accounting information to the 


installation’s accounting routines. 


References: For more information on how to add accounting routines, see SPL: System 
Management Facilities. 


Syntax: 


ACCT[ .procstepname]=(accounting-information) 


Single Subparameter: You can omit the parentheses if the accounting information consists of 
only one subparameter. 


Length: The entire accounting-information must not exceed 142 characters: 
e Including any commas, which are considered part of the information. 


e Excluding any enclosing parentheses or apostrophes, which are not considered part of 
the information. 


Multiple Subparameters: When the accounting-information consists of more than one 
subparameter, separate the subparameters by commas and enclose the information in 


parentheses or apostrophes. For example, ACCT =(5438,GROUP6) or 
ACCT =’5438,GROUP6’. 


Special Characters: When a subparameter contains special characters, other than hyphens or 
plus zero (+0, an overpunch), enclose it in apostrophes and the information in parentheses 
or enclose all of the information in apostrophes. For example, ACCT = (387,’72/159’) or 
ACCT = '387,72/159’. 


Code each apostrophe that is part of the accounting-information as two consecutive 
apostrophes. For example, code DEPT’D58 as ACCT =’DEPT’DS8’ 


Continuation onto Another Statement: Enclose the accounting-information in parentheses. 
End each statement with a comma after a complete subparameter. For example: 


//STEP1 EXEC PGM=WRITER, ACCT=(1417,J318,'D58/920','CHG=2', 
// '33.95') 
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Subparameter Definition 


accounting-information 
Specifies one or more subparameters of accounting information, as defined by the 
installation. 


On EXEC Statement that Calls a Procedure 


If the EXEC statement calls a cataloged or in-stream procedure, the ACCT parameter overrides 
the ACCT parameter on or is added to: 


@ The EXEC statement named in the procstepname qualifier. The information applies only 
to the named procedure step. The EXEC statement can have as many ACCT.procstepname 
parameters as the procedure has steps; each ACCT parameter must specify a unique 
procstepname. 


e All EXEC statements in the procedure if procstepname is not coded. Then the information 
applies to all steps in the called procedure. 


Examples of the ACCT Parameter 


//STEP1 EXEC PGM=JP5,ACCT=(LOCATIONS, 'CHGE+3') 


This EXEC statement executes program JPS and specifies accounting information for this job 
step. 


//STP3 EXEC PROC=LOOKUP,ACCT=('/83468') 


This EXEC statement calls cataloged or in-stream procedure LOOKUP. The accounting 
information applies to this job step, STP3, and to all the steps in procedure LOOK UP. 


//STP4 EXEC PROC=BILLING, ACCT. PAID=56370,ACCT.LATE=56470, 
// ACCT.BILL='121+366' ) 


This EXEC statement calls cataloged or in-stream procedure BILLING. The statement 
specifies different accounting information for each of the procedure steps: PAID, LATE, and 
BILL. 
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ADDRSPC Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the ADDRSPC parameter to indicate to the system that the job step requires 
virtual storage (pageable) or real storage (nonpageable). 


Syntax: 


REAL 


ADDRSPC[.procstepname]= want 


Subparameter Definition 


Defaults 


Overrides 


VIRT 
Requests virtual storage. The system can page the job step. 


REAL 
Requests real storage. The system cannot page the job step and must place the job step in 
real storage. 


If no ADDRSPC parameter is specified, the default is VIRT. 


The JOB statement ADDRSPC parameter applies to all steps of the job and overrides any 
EXEC statement ADDRSPC parameters. 


Code EXEC statement ADDRSPC parameters when each job step requires different types of 
storage. The system uses an EXEC statement ADDRSPC parameter only when no ADDRSPC 
parameter is on the JOB statement and only during the job step. 


Relationship to the EXEC REGION Parameter 


When ADDRSPC=REAL: Code a REGION parameter to specify how much real storage the 
job needs. If you omit the REGION parameter, the system uses the default. 


When ADDRSPC= VIRT or ADDRSPC is Omitted: Code a REGION parameter to specify 


how much virtual storage the job needs. If you omit the REGION parameter, the system uses 
the default. 
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On EXEC Statement that Calls a Procedure 


If this EXEC statement calls a cataloged or in-stream procedure, the ADDRSPC parameter 
overrides the ADDRSPC parameter on or is added to: 


e The EXEC statement named in the procstepname qualifier. The parameter applies only to 
the named procedure step. The EXEC statement can have as many 
ADDRSPC.procstepname parameters as the procedure has steps; each ADDRSPC 
parameter must specify a unique procstepname. 


e All EXEC statements in the procedure if procstepname is not coded. Then the parameter 
applies to all steps in the called procedure. 


Examples of the ADDRSPC Parameter 


//CAC1 EXEC PGM=A,ADDRSPC=VIRT 


This EXEC statement executes program A and requests virtual (pageable) storage. Because the 
REGION parameter is not specified, the storage available to this job step is the installation 
default or the region size specified on the JOB statement. 


//CAC2 EXEC PROC=B,ADDRSPC=REAL, REGION=80K 


This EXEC statement calls procedure B and requests real (nonpageable) storage. The 
REGION parameter specifies 80K of storage. 
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COND Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the COND parameter to specify the return code tests the system is to use to 
determine whether to bypass or execute this job step. The system performs each COND 
parameter test against the return code from every previous job step that executed or from the 
named previous job step(s). If none of these tests is satisfied, the system executes this job step; 
if any test is satisfied, the system bypasses this job step. 


Bypassing a step because of a return code test is not the same as abnormally terminating the 
step. The system abnormally terminates a step following an error so serious that it prevents 
successful execution. In contrast, bypassing of a step is merely its omission. 


If a step abnormally terminates, the system normally bypasses all following st ps in the job. To 
make the system execute a following step, for instance, to write a dump, code EVEN or ONLY 
on that step’s EXEC statement. The EVEN or ONLY subparameters are interpreted first. If 
they indicate that the step should be executed, then the return code tests, if specified, are 
performed. If no return code tests were coded or if none of the coded tests is satisfied, the 
system executes the step. 


Instead of coding a JOB statement COND parameter, code an EXEC statement COND 
parameter when you want to: 


e Specify different tests for each job step. 
e Name a specific step whose return code the system is to test. 
e Specify special conditions for executing a job step. 


e Bypass only one step. When a step is bypassed because of a JOB COND parameter, all 
following steps in the job are bypassed. 


A COND parameter on the first EXEC statement in a job is meaningless. 


The tests are made against return codes from the current execution of the job. Ifa return code 
test specifies a previous step that was bypassed, the test is ignored. 


Note: In both JES2 and JES3 systems, an EXEC COND parameter determines if a step is 


executed or bypassed. However, JES3 processes all jobs as though each step will execute; 
therefore, JES3 allocates devices for steps that are bypassed. 
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Syntax: 


COND[ .procstepname]=(code,operator) 


COND[.procstepname]=/(code,operator[,stepname] [.procstepname] ) 


COND=EVEN 
COND=ONLY 


[, (code,operator[,stepname][.procstepname])]... 


, EVEN 
, ONLY 


One return code test is: (code,operator) 


You can omit the outer parentheses if you code only one return code test or only EVEN or ONLY. 


Specify up to eight return code tests. However, if you code EVEN or ONLY, specify up to seven 
return code tests. 


You can omit all return code tests and code only EVEN or ONLY. 


Place the EVEN or ONLY subparameters before, between, or after the return code tests. 


Subparameter Definition 


code 


Specifies a number that the system compares to the return codes from all previous steps in 
the job or from specific steps. code is a decimal number from 0 through 4095. 


Note: Specifying a decimal number greater than 4095 could result in invalid return code 
testing or invalid return codes in messages. 


operator 


Specifies the type of comparison to be made to the return code. If the specified test is 
true, the step is bypassed. Use the chart on page 14-13 to select the correct operator. 
Operators and their meanings are: 


Operator Meaning 

GT Greater than 

GE Greater than or equal to 

EQ Equal to 

NE Not equal to 

LT Less than 

LE Less than or equal to 
stepname 


Identifies the EXEC statement of a previous job step that issues the return code to be 
used in the test. If the specified step is in a procedure, this step must be in the same 
procedure; otherwise, the specified step must not be in a procedure. 


If you omit stepname, the code you specify is compared to the return codes from all 
previous steps. 
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stepname.procstepname 


Identifies a step in a cataloged or in-stream procedure called by an earlier job step. 
Stepname identifies the EXEC statement of the calling job step; procstepname identifies 
the EXEC statement of the procedure step that issues the return code to be used in the 
test. 


EVEN 


Specifies that this job step is to be executed even if a preceding job step abnormally 
terminated. When EVEN is coded, the system: 


e Does not test the return code of any steps that terminated abnormally. 


e Does test the return code of any steps that terminated normally. If none of the return 
code tests for these steps is satisfied, this job step is executed. 


If the operator terminated a job step with a CANCEL command, the system ignores 
EVEN. 


ONLY 


Overrides 


Specifies that this job step is to be executed only if a preceding step abnormally 
terminated. When ONLY is coded, the system: 


e Does not test the return code of any steps that terminated abnormally. 


e Does test the return code of any steps that terminated normally. If none of the return 
code tests for these steps is satisfied, this job step is executed. 


If the operator terminated a job step with a CANCEL command, the system ignores 
ONLY. 


If you code the COND parameter on the JOB statement and on one or more of the job’s EXEC 
statements, and if a return code test on the JOB statement is satisfied, the job terminates. In 
this case, the system ignores any EXEC statement COND parameters. 


If the tests on the JOB statement are not satisfied, the system then performs the return code 
tests on the EXEC statement. Ifa return code test is satisfied, the step is bypassed. 


On EXEC Statement that Calls a Procedure 


If this EXEC statement calls a cataloged or in-stream procedure, the COND parameter 
overrides the COND parameter on or is added to: 


The EXEC statement named in the procstepname qualifier, which is to the left of the equals 
sign. The parameter applies only to the named procedure step. The EXEC statement can 
have as many COND.procstepname parameters as the procedure has steps; each COND 
parameter must specify a unique procstepname. 


All EXEC statements in the procedure if procstepname is not coded. Then the parameter 
applies to this job step and to all steps in the called procedure. 
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Cautions when Specifying COND Parameters 


Backward References to Data Sets: If a step is bypassed because of its COND parameter or if 2 
a step abnormally terminates, a data set that was to have been created or cataloged in the step 

may not exist, may not be cataloged, or may be incomplete. Thus, a job step should not refer 

to a data set being created or cataloged in a step that could be bypassed or abnormally 

terminated. 


JOBLIB and COND=ONLY: If the job contains a JOBLIB DD statement and ONLY is 
specified in a job step, the JOBLIB unit and volume information are not passed to the next 
step; when the next step is executed, the system searches the catalog for the JOBLIB data set. 


Job Time Out: The system abnormally terminates a job with a system completion code of 322 
if the EXEC or JOB statement TIME parameter or the default time limit specified at JES 
initialization is exceeded. This time out occurs regardless of any COND parameters. 


When the JOB Statement Contains a RESTART Parameter: When restarting a job, do not 
specify in the deferred restart step or in any following steps a COND parameter that refers to a 
stepname or stepname.procstepname for a step before the restart step. The system ignores any 
COND parameters that refer to preceding steps. 
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Summary of COND Parameters 


Return Code (RC) from a Previous Step 


Test in COND Parameter Bypass 
Current Step 


COND = (code,GT) RC RC < code 


COND = (code,GE) RC RC < code 
COND = (code,EQ) RC RC = code 
COND = (code,LT) RC RC > code 
COND = (code, LE) RC RC > code 
COND = (code,NE) RC RC —= code 


Figure 14-1. Execution or Bypassing of Current Step Based on COND Parameter 


EVEN or ONLY Any Preceding Any Tests Current Step 
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Figure 14-2. Effect of EVEN and ONLY Subparameters on Step Execution 
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Examples of the COND Parameter 


//STEP6 EXEC PGM=DISKUTIL,COND=(4,GT,STEP3) 
In this example, if the return code from STEP3 is 0 through 3, the system bypasses STEP6. If 


the return code is 4 or greater, the system executes STEP6. Because neither EVEN nor ONLY 
is specified, the system does not execute this step if a preceding step abnormally terminates. 


//TEST2 EXEC PGM=DUMPINT,COND=((16,GE),(90,LE,STEP1) ,ONLY) 
The system executes this step ONLY if two conditions are met: 


1. A preceding job step abnormally terminated. 
2. No return code tests are satisfied. 


Therefore, the system executes this step only when all three of the following are true: 


e A preceding job step abnormally terminated. 
e The return codes from all preceding steps are 17 or greater. 
@ The return code from STEP! is 89 or less. 


The system bypasses this step if any one of the following is true: 


e All preceding job steps terminated normally. 
@ The return code from any preceding step is 0 through 16. ) 


e@ The return code from STEP! is 90 or greater. 


//STEP1 EXEC PGM=CINDY 
//STEP2 EXEC PGM=NEXT,COND=(4,EQ,STEP1) 


//STEP3 EXEC PGM=LAST,COND=((8,LT,STEP1),(8,GT,STEP2) ) 


In this example, if STEP1 returns a code of 4, STEP2 is bypassed. Before STEP3 is executed, 
the system performs the first return code test. If 8 is less than the return code from STEP1, 
STEP3 is bypassed; or, restated, if the STEP! return code is less than or equal to 8, STEP3 is 
executed. Because 4 is less than 8, STEP3 is executed. 


The system does not perform the second return code test because STEP2 was bypassed. 


//STP4 EXEC PROC=BILLING,COND.PAID=((20,LT) ,EVEN), 
// COND.LATE=(60,GT,FIND), 
// COND. BILL=((20,GE) ,(30,LT,CHGE) ) 


This statement calls cataloged or in-stream procedure BILLING. The statement specifies 
different return code tests for each of the procedure steps: PAID, LATE, and BILL. The 
system executes step PAID even if a preceding step abnormally terminates unless the 
accompanying return code is satisfied. 
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EXEC: DPRTY 


DPRTY Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the DPRTY parameter to assign a dispatching priority to the address space for 
this job step. The system uses the dispatching priority to determine the order in which to 
execute tasks. 


Syntax: 


DPRTY[.procstepname]=({valuel][,value2]) 


@ You can omit the parentheses if you code only valuel. 


e You must include the parentheses and code a comma before value2 if you code only 
value2. 


Subparameter Definition 


valuel 


Indicates whether this job step is to have the same or a different priority than the job. 
valuel is a number from 0 through 15. 


JES2 determines the job priority from the following, in override order: 


I 


2: 


3. 


4. 


A JES2 /*PRIORITY statement. 
A PRTY parameter on the JOB statement. 


A value calculated from the accounting information on a JES2 /*JOBPARM 
statement or the JOB statement. 


An installation default specified at JES2 initialization. 


JES3 determines the job priority from the following, 1n override order: 


1. 


A PRTY parameter on the JOB statement. If the specified priority is invalid, JES3 
issues an error message. 


2. An installation default specified at JES3 initialization. 


value2 


Specifies a number to be added to valuel to form the dispatching priority. value2 is a 
number from 0 through 15. The system forms the internal dispatching priority as follows: 


dispatching priority = (valuel * 16) + value2 
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Defaults 


If you omit the DPRTY parameter, the system assigns the job step the automatic priority group J 
(APG) priority. 


If you omit valuel or it is equal to the APG priority, the system assigns the step the APG 
priority and ignores value2. In this case, the system obtains value2 from the installation 
performance specification (IPS) using the performance group associated with the job step. See 


SPL: Initialization and Tuning for information on IPS. If value2 is not specified in the IPS, the 
system makes value2 equal to 6. 


Relationship to Other Control Statements 


For the step, the DPRTY parameter overrides the job’s priority. 


On EXEC Statement that Calls a Procedure 


If this EXEC statement calls a cataloged or in-stream procedure, the DPRTY parameter 
overrides the DPRTY parameter on or is added to: 


e The EXEC statement named in the procstepname qualifier. The parameter applies only to 
the named procedure step. The EXEC statement can have as many DPRTY.procstepname 
parameters as the procedure has steps; each DPRTY parameter must specify a unique 
procstepname. 


e All EXEC statements in the procedure if procstepname is not coded. Then the parameter 
applies to this job step and to all steps in the called procedure. 


Examples of the DPRTY Parameter 


//BP2 EXEC PGM=FOUR,DPRTY=(13,9) 


The system uses the values in this DPRTY parameter to form a dispatching priority for this 
step. Because the numbers are relatively high, the dispatching priority will be high: 217. 


//STEP EXEC PROC=CLEAN,DPRTY=(11,7) 


This EXEC statement calls a cataloged procedure named CLEAN, which has three steps. The 
DPRTY parameter applies to all three steps. The dispatching priority is 183. 


//STEP EXEC PROC=CLEAN,DPRTY.UP=(10,7) 


In this statement, the DPRTY parameter applies only to the procedure step UP. The 
dispatching priority for UP is 167. 
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DYNAMNBR Parameter 


Parameter Type: Keyword, optional 
Purpose: Use the DYNAMNBR parameter to tell the system to hold a number of resources in 
anticipation of reuse. Code DYNAMNBR instead of several DD statements with DYNAM 


parameters. 


Syntax: 


DYNAMNBR[.procstepname]=n 


Subparameter Definition 


n 
Specifies a value used to calculate the maximum number of data set allocations that the 
system can hold in anticipation of reuse. Specify n as a decimal number from 0 through 
3273 minus the number of DD statements in the step. 


Note that the limit of 3273 is based on the number of single unit DD statements for a 
64K TIOT (task input output table). This limit can be different depending on the 
installation-defined TIOT size. 32K is the default TIOT size. The limit for a 32K TIOT 
is 1635. 


The number of resources that the system actually holds in anticipation of reuse equals n 
plus the number of DD statements in the step, including any DD statements in a 
cataloged or in-stream procedure called by the step. 


Defaults 


If no DYNAMNBR parameter is specified, the default is 0. If you code DYNAMNBR 
incorrectly, the system uses the default of 0 and issues a JCL warning message. 


On EXEC Statement that Calls a Procedure 


If this EXEC statement calls a cataloged or in-stream procedure, the DY NAMNBR parameter 
overrides the DYNAMNBR parameter on or is added to: 


e The EXEC statement named in the procstepname qualifier. The parameter applies only to 
the named procedure step. The EXEC statement can have as many 
DYNAMNBR.procstepname parameters as the procedure has steps; each DYNAMNBR 
parameter must specify a unique procstepname. 

e All EXEC statements in the procedure if procstepname is not coded. Then the parameter 
applies to all steps in the called procedure. 
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Example of the DYNAMNBR Parameter 


//STEP1L EXEC PROC=ACCT,DYNAMNBR.CALC=12 


For the procedure step CALC, this statement specifies that the system should hold the 
following data set allocations for reuse: 12 plus the number of DD statements following this 
EXEC statement and the number of DD statements in procedure ACCT. 
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PARM Parameter 


C 


Use the PARM parameter to pass variable information to the processing program executed by 
this job step. To use the information, the processing program must contain instructions to 
retrieve the information. 


References.: For details on the format of the passed information and its retrieval, see 
Supervisor Services and Macro Instructions. 


Syntax: 


PARM[ .procstepname]=information 


Length: The entire information passed must not exceed 100 characters: 


C e Including any commas, which are passed to the processing program. 
e Excluding any enclosing parentheses or apostrophes, which are not passed. 


For example, PARM =’P1,123,MTS’ is received by the program as P1,123,MTS. 


Commas: When the information consists of more than one expression, separate the 
expressions by commas and enclose the information in parentheses or apostrophes. For 
example, PARM =(P1,123,MT5) or PARM = ’P1,123,MTS’. 


t Special Characters and Blanks: When an expression contains special characters or blanks, 
enclose it in apostrophes and the information in parentheses or all the information in 
apostrophes. For example, PARM =(PS0,’12 + 80’) or PARM =’PS0,12 + 80’. 


Code each apostrophe and ampersand that is part of the information as two consecutive 
apostrophes or ampersands. For example, code 3462&5 as PARM ='3462&&5’. 


However, if an expression contains a symbolic parameter, code a single ampersand and do not 
enclose the expression in apostrophes, for example, PARM=&UNIT. 


( | Continuation onto Another Statement: Enclose the information in parentheses. End each 
statement with a comma after a complete expression. For example: 


//STEP1 EXEC PGM=WORK, PARM= (DECK, LIST, 'LINECNT=80', 
Tif '12+80' , NOMAP) 


Subparameter Definition 


information 
Consists of the information to be passed to the processing program. 
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On EXEC Statement that Calls a Procedure 


If this EXEC statement calls a cataloged or in-stream procedure, the PARM parameter J 
overrides the PARM parameter on or is added to: 


@ The EXEC statement named in the procstepname qualifier. The information applies only 
to the named procedure step. The EXEC statement can have as many 
PARM.procstepname parameters as the procedure has steps; each PARM parameter must 
specify a unique procstepname. 


e The first EXEC statement in the procedure if procstepname is not coded; the system 


nullifies any PARM parameters on any following EXEC statements in the procedure. The 
information applies to only the first step in the called procedure. 


Examples of the PARM Parameter 


//RUN3 EXEC PGM=APG22,PARM='P1,123,P2=5' < 
The system passes P1,123,P2=5 to the processing program named APG22. 
// EXEC PROC=PROC81,PARM=MT5 


The system passes MTS to the first step of the procedure named PROC81. If PROC81 contains 
more steps and their EXEC statements contain PARM parameters, the system nullifies those 


PARM parameters. ) 


//STP6 EXEC PROC=ASMFCLG,PARM.LKED=(MAP,LET) 


The system passes MAP,LET to the procedure step named LKED in procedure ASMFCLG. If 
any other procedure steps in ASMFCLG contain a PARM parameter, those PARM parameters 
remain in effect. 


//RUN4 EXEC PGM=IFOX00,PARM=(NOOBJECT, 'LINECNT=50', 
// DECK) 


The system passes NOOBJECT,LINECNT = 50,DECK to processing program IFOX00. 
Because the PARM parameter is continued on a second statement, the information is enclosed 
in parentheses; notice that the continuation occurs after a comma following a complete 
expression. 
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PERFORM Parameter 


Parameter Type: Keyword, optional 
Purpose: Use the PERFORM parameter to specify the performance group for the job step. 
The installation-defined performance groups determine the rate at which associated steps have 


access to the processor, storage, and channels. 


Syntax: 


PERFORM[.procstepname]=n 


Subparameter Definition 


Defaults 


Overrides 


n 
Requests a performance group. The n is a number from | through 999 and must identify 
a performance group that has been defined by your installation. The specified 
performance group should be appropriate for your step type according to your 
installation’s rules. 


If no PERFORM parameter is specified or if the specified PERFORM number fails validity 
checks, the system uses an installation default specified at initialization. If the installation did 
not specify a default, the system uses a built-in default: 


Default Use 
1 For non-TSO job steps 
2 For TSO sessions 


See SPL: Initialization and Tuning for details. 


A JOB statement PERFORM parameter applies to all steps of the job and overrides any EXEC 
statement PERFORM parameters. 


Code EXEC statement PERFORM parameters when each job step is to execute in a different 


performance group. The system uses an EXEC PERFORM parameter only when no 
PERFORM parameter is on the JOB statement and only during the job step. 


Chapter 14. EXEC Statement 14-21 


EXEC: PERFORM 


On EXEC Statement that Calls a Procedure 


If this EXEC statement calls a cataloged or in-stream procedure, the PERFORM parameter - 
overrides the PERFORM parameter on or is added to: 


@ The EXEC statement named in the procstepname qualifier. The parameter applies only to 
the named procedure step. The EXEC statement can have as many 
PERFORM. procstepname parameters as the procedure has steps; each PERFORM 
parameter must specify a unique procstepname. 


@ All EXEC statements in the procedure if procstepname is not coded. Then the parameter 
applies to all steps in the called procedure. 


Example of the PERFORM Parameter 


//STEPA EXEC PGM=ADDER,PERFORM=60 


This job step will be run in performance group 60 if it passes validity checks. The installation 
must have defined the significance of this performance group. 


[4-22 MVS/XA JCL Reference 


EXEC: PGM 


PGM Parameter 


Parameter Type: Positional, optional 


Purpose: Use the PGM parameter to name the program that the system is to execute. The 
specified program must be a member of a partitioned data set used as a system library, a 
private library, or a temporary library. 


Syntax: 


program-name 
PGM=|*.stepname.ddname 

*,stepname.procstepname.ddname 

JCLTEST 

JSTTEST 


The EXEC statement parameter field must begin with a PGM parameter or a PROC 
parameter. These two parameters must not appear on the same EXEC statement. 


Subparameter Definition 


program-name 
Specifies the member name or alias of the program to be executed. The program-name is 
1 through 8 alphanumeric or national ($, #, @) characters; the first character must be 
alphabetic or national ($, #, @). 


Use this form of the parameter when the program resides in a system library, such as 
SYS1.LINKLIB, or in a private library specified in the job by a JOBLIB DD statement 
or in the step by a STEPLIB DD statement. 


* stepname.ddname 
Refers to a DD statement that defines, as a member of a partitioned data set, the 
program to be executed. Stepname identifies the EXEC statement of the earlier job step 
that contains the DD statement with ddname in its name field. 


Use this form of the parameter when a previous job step creates a temporary library to 
store a program until it is required. 


When referring to a DD statement, the system does not honor requests for special 
program properties as defined in the program properties table (PPT). (See SPL: System 
Modifications.) 


* stepname. procstepname.ddname 
Refers to a DD statement that defines, as a member of a partitioned data set, the 
program to be executed. The DD statement is in a cataloged or in-stream procedure that 
is called by an earlier job step. Stepname identifies the EXEC statement of the calling job 
step; procstepname identifies the EXEC statement of the procedure step that contains the 
DD statement with ddname in its name field. 


Use this form of the parameter when a previous job step calls a procedure that creates a 
temporary library to store a program until it is required. 
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When referring to a DD statement, the system does not honor requests for special 
program properties as defined in the program properties table (PPT). (See SPL: System 
Modifications.) 


JCLTEST (JES3 only) 

JSTTEST (JES3 only) 
Requests that the system scan the step’s job control statements for syntax errors without 
executing the job or allocating devices. JCLTEST or JSTTEST provides for a step the 
same function as provided by the JOB statement TYPRUN =SCAN parameter for a job. 
See JES3 Diagnosis for details. 


Note: JCLTEST and JSTTEST are supported only in JES3 systems. 


Examples of the PGM Parameter 


//JOB8 JOB’ ,BOB,MSGLEVEL=(2,0) ) 
//JOBLIB DD DSNAME=DEPT12.LIB4,DISP=(OLD, PASS) 
//STEP1 EXEC PGM=USCAN 


These statements indicate that the system is to search the private library DEPT12.LIB4 for the 
member named USCAN, read the member into storage, and execute the member. 


//PROCESS JOB ,MARY,MSGCLASS=A 

//CREATE EXEC PGM=IEWL 

//SYSLMOD DD DSNAME=&&PARTDS (PROG) , UNIT=3350,DISP=(MOD,PASS), 
SPACE=(1024,(50,20,1)) j 


// 
//GO EXEC PGM=*.CREATE.SYSLMOD 


The EXEC statement named GO contains a backward reference to DD statement SYSLMOD, 
which defines a library created in the step named CREATE. Program PROG is a member of 
the partitioned data set &&PARTDS, which is a temporary data set. Step GO executes 
program PROG. The data set &&PARTDS is deleted at the end of the job. 


//JOBC JOB’ ,JOHN,MSGCLASS=H 

//STEP2 EXEC PGM=UPDT 
//DDA DD DSNAME=SYS1.LINKLIB(P40) ,DISP=OLD ») 
//STEP3 EXEC PGM=*.STEP2.DDA 


The EXEC statement named STEP3 contains a backward reference to DD statement DDA, 
which defines system library SYS1.LINKLIB. Program P40 is a member of SYS1.LINKLIB; 
STEP3 executes program P40. 
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PROC and Procedure Name Parameters 


Parameter Type: Positional, optional 


Purpose: Use the PROC parameter to specify that the system is to call and execute a cataloged 
or in-stream procedure. 


Syntax: 


PROC=procedure~name 
procedure-name 


@e The EXEC statement parameter field must begin with a PGM parameter or a PROC 
parameter. These two parameters must not appear on the same EXEC statement. 


e You can omit PROC= and code only the procedure-name. 


Subparameter Definition 


procedure-name 
Identifies the procedure to be called and executed: 


@ The member name or alias of a cataloged procedure. 


e The name on the PROC statement that begins an in-stream procedure. The in-stream 
procedure must appear earlier in this job. 


The procedure-name is 1 through 8 alphanumeric or national ($, #, @) characters; the 
first character must be alphabetic or national ($, #, @). 


Effect of PROC Parameter on Other Parameters and Following Statements 
Because this EXEC statement calls a cataloged or in-stream procedure, the other parameters on 


the statement are added to or override corresponding parameters on the EXEC statements in 
the called procedure. See the descriptions of the other parameters for details of their effects. 


Any DD statements following this EXEC statement are added to the procedure, or override or 
nullify corresponding DD statements in the procedure. 


Examples of the PROC Parameter 


//SP3 EXEC PROC=PAYWKRS 


This statement calls the cataloged or in-stream procedure named PAYWKRS. 


//BK EXEC OPERATE 


This statement calls the cataloged or in-stream procedure named OPERATE. 
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RD Parameter 


Parameter Type: Keyword, optional 
Purpose: Use the RD (restart definition) parameter to: 
@ Specify that the operator is to perform automatic step restart if the job fails. 


e Suppress, partially or totally, the action of the assembler language CHKPT macro 
instruction or the DD statement CHKPT parameter. 


The system can perform automatic restart only if all of the following are true: 


The JOB or EXEC statement contains RD=R or RD=RNC. 

The step to be restarted returned a completion code that indicated no error in the step. 
The operator authorizes a restart. 

The job has a job journal. 


A job journal is a sequential data set that contains job-related control blocks needed for restart. 
For JES2, specify a job journal by one of the following: 


e Aninstallation option during JES2 initialization. 
e RD=R or RD=RNC on either the JOB statement or any one EXEC statement in the job. 


For JES3, specify a job journal in one of the following: 


e An installation option during JES3 initialization. 
e RD=R or RD=RNC on either the JOB statement or any one EXEC statement in the job. 
e JOURNAL=YES on a JES3 //*MAIN statement in the job. 


References: For detailed information on deferred checkpoint restart, see Checkpoint/Restart 
User’s Guide. 


Syntax: 


P| 
RD[.procstepname]=(R J 
RNC 


NR 
NC 
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EXEC: RD 


Subparameter Definition 


R (Restart, Checkpoints Allowed) 
Indicates that the operator is to perform automatic step restart if the job step fails. 


RD=R does not suppress checkpoint restarts: 


e If the processing program executed in a job step does not include a CHKPT macro 
instruction, RD=R allows the system to restart execution at the beginning of the 
abnormally terminated step. 


e If the program includes a CHKPT macro instruction, RD=R allows the system to 
restart execution at the beginning of the step, if the step abnormally terminates before 
the CHKPT macro instruction is executed. 


e Ifthe step abnormally terminates after the CHKPT macro instruction is executed, 
only checkpoint restart can occur. If you cancel the affects of the CHKPT macro 
instruction before the system performs a checkpoint restart, the request for automatic 
step restart is again in effect. 


RNC (Restart, No Checkpoints) 
Indicates that the operator is to perform automatic step restart if the job step fails. 


RD=RNC suppresses automatic and deferred checkpoint restarts. It suppresses: 

e Any CHKPT macro instruction in the processing program: That is, the operator is 
not to perform an automatic checkpoint restart, and the system is not to perform a 
deferred checkpoint restart if the job is resubmitted. 

e The DD statement CHKPT parameter. 

e@e The checkpoint at end-of-volume (EOV) facility. 


NR (No Automatic Restart, Checkpoints Allowed) 
Indicates that the operator is not to perform automatic step restart if the job fails. 


RD=NR suppresses automatic checkpoint restart but permits deferred checkpoint 
restarts. It permits: 


e A CHKPT macro instruction to establish a checkpoint. 


e The job to be resubmitted for restart at the checkpoint. On the JOB statement when 
resubmitting the job, specify the checkpoint in the RESTART parameter. 


If you code RD=NR and the system fails, RD=NR does not prevent the job from 
restarting. 
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NC (No Automatic Restart, No Checkpoints) 


Defaults 


Indicates that the operator is not to perform automatic step restart if the job step fails. 
RD=NC suppresses automatic and deferred checkpoint restarts. It suppresses: 
e Any CHKPT macro instruction in the processing program. 


e The DD statement CHKPT parameter. 
@ The checkpoint at EOV facility. 


If you do not code the RD parameter, the system uses the installation default from the job’s job 
class specified at initialization. 


Overrides 


A JOB statement RD parameter applies to all steps of the job and overrides any EXEC 
statement RD parameters. 


When no RD parameter is on the JOB statement, the system uses an EXEC statement RD 
parameter, but only during the job step. Code EXEC statement RD parameters when you 
want to specify different restart types for each job step. 


A request by a CHKPT macro instruction for an automatic checkpoint restart overrides a 
request by a JOB or EXEC statement RD=R parameter for automatic step restart. 


Relationship to Other Control Statements 


Code RD=NC or RD=RNC to suppress the action of the DD statement CHKPT parameter. 


On EXEC Statement that Calls a Procedure 


If the EXEC statement calls a cataloged or in-stream procedure, the RD parameter is added to 
or overrides the RD parameter on: 


The EXEC statement named in the procstepname qualifier. The information applies only 
to the named procedure step. The EXEC statement can have as many RD.procstepname 
parameters as the procedure has steps; each RD parameter must specify a unique 
procstepname. 


All EXEC statements in the procedure if procstepname is not coded. Then the parameter 
applies to all steps in the called procedure. 
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EXEC: RD 


Examples of the RD Parameter 


//STEP1 EXEC PGM=GIIM,RD=R 
RD=R specifies that the operator is to perform automatic step restart if the job step fails. 
//NEST EXEC PGM=T18,RD=RNC 


RD=RNC specifies that, if the step fails, the operator is to perform automatic step restart. 
RD=RNC suppresses automatic and deferred checkpoint restarts. 


//CARD EXEC PGM=WTE,RD=NR 


RD=NR specifies that the operator is not to perform automatic step restart or automatic 
checkpoint restart. However, a CHKPT macro instruction can establish checkpoints to be used 
later for a deferred restart. 


//STP4 EXEC PROC=BILLING,RD.PAID=NC,RD.BILL=NR 


This statement calls a cataloged or in-stream procedure BILLING. The statement specifies 
different restart requests for each of the procedure steps: PAID and BILL. 
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EXEC: REGION 


REGION Parameter 


Parameter Type: Keyword, optional 

Purpose: Use the REGION parameter to specify the amount of space that the step requires. 
The specified or default region size sets an upper boundary to limit region size for 
variable-length GETMAINs. The system uses the upper boundary for variable-length 


GETMAINs as long as the region still has available at least the minimum amount of storage 
requested. 


In addition, the IBM- or installation-supplied routine IEFUSI uses the region size to establish a 
second limiting value. The system uses this second value to limit: 


e Fixed-length GETMAINSs. 


@ Variable-length GETMAINs when the space remaining in the region is less than the 
requested minimum. 


When the minimum requested length for variable-length GETMAINSs or the amount requested 
for a fixed-length GETMAIN exceeds this second value, the job step abnormally terminates. 


Specifying a Region Size Value: If your installation does not change the IBM-supplied default 
limits in the IEALIMIT and/or IEFUSI exit routine modules, then specifying various values for 
the region size have the following results: 


e A value equal to OK or OM -- gives the job step all the storage available below and above 
16 megabytes. The resulting size of the region below and above 16 megabytes is 
unpredictable. 


e A value greater than OK or 0M and less than or equal to 16384K or 16M -- establishes the 
size of the private area below 16 megabytes. If the region size specified is not available 
below 16 megabytes, the job step abnormally terminates. The extended region size is the 
default value of 32 megabytes. 


e A value greater than 16384K or 16M and less than or equal to 32768K or 32M -- gives the 
job step all the storage available below 16 megabytes. The resulting size of the region 
below 16 megabytes is unpredictable. The extended region size is the default value of 32 
megabytes. 


e A value greater than 32768K or 32M and less than or equal to 2096128K or 2047M -- gives 
the job step all the storage available below 16 megabytes. The resulting size of the region 
below 16 megabytes is unpredictable. The extended region size is the specified value. If the 
region size specified is not available above 16 megabytes, the job step abnormally 
terminates. 


References: For more information on the region size, see SPL: System Modifications. For 
more information on region size with checkpoint/restart jobs, see Checkpoint/Restart User's 
Guide. 


14-30 MVS/XA JCL Reference 


EXEC: REGION 


Syntax: 


REGION[.procstepname]= |valueK 


valueM 


Subparameter Definition 


valueK 
Specifies the required storage in kilobytes (1 kilobyte = 1024 bytes). The value is 1 
through 7 decimal numbers, from 1 through 2096128. Code an even number. For 
example, REGION = 66K. If you code an odd number, the system treats it as the next 
highest even number. 


valueM 


Specifies the required storage in megabytes (1 megabyte = 1024 kilobytes). The value is 
1 through 4 decimal numbers, from 1 through 2047. Code either an even or odd number. 
For example, REGION =3M. 


Defaults 


If no REGION parameter is specified, the system uses an installation default specified at JES 
initialization. 


Overrides 


A JOB statement REGION parameter applies to all steps of the job and overrides any EXEC 
statement REGION parameters. 


When no REGION parameter is on the JOB statement, the system uses an EXEC statement 
REGION parameter, but only during the job step. Code EXEC statement REGION 
parameters when you want to specify a different region size for each job step. 


Relationship to the EXEC ADDRSPC Parameter 


When ADDRSPC= REAL: Code a REGION parameter to specify how much real storage the 
job needs. If you omit the REGION parameter, the system uses the default. 


When ADDRSPC = VIRT or ADDRSPC is Omitted: Code a REGION parameter to specify 
how much virtual storage the job needs. If you omit the REGION parameter, the system uses 
the default. 


On EXEC Statement that Calls a Procedure 


If the EXEC statement calls a cataloged or in-stream procedure, the REGION parameter is 
added to or overrides the REGION parameter on: 


@ The EXEC statement named in the procstepname qualifier. The information applies only 
to the named procedure step. The EXEC statement can have as many 
REGION.procstepname parameters as the procedure has steps; each REGION parameter 
must specify a unique procstepname. 
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e All EXEC statements in the procedure if procstepname is not coded. Then the parameter 
applies to all steps in the called procedure. 


Examples of the REGION Parameter 


//MKBOYLE EXEC PROC=A,ADDRSPC=REAL , REGION=40K 
The system assigns 40K bytes of real storage to this job step. 
//STP6 EXEC PGM=CONT,REGION=120K 


The system assigns a region of 120K bytes. When the ADDRSPC parameter is not specified, 
the system defaults to ADDRSPC=VIRT. 
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EXEC: TIME 


TIME Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the TIME parameter to specify the maximum length of time that a job step is to 
use the processor and to find out through messages how much processor time the step used. 


A step that exceeds its allotted time abnormally terminates and causes termination of the job, 
unless a user exit routine extends the time for the job. The exit routine is established through 
System Management Facilities (SMF). 

References: See SPL: System Management Facilities (SMF). 


Syntax: 


elas iia (7 aaa 
1440 


You can omit the parentheses if you code only 1440 or the processor time in minutes. 


Subparameter Definition 


minutes 
Specifies the maximum number of minutes the step can use the processor. The minutes 
must be a number from 1 through 1439. 


Code TIME=0 on the EXEC statement to indicate that the step is to use the unexpired 
time from the previous step. If this step exceeds that unexpired time, it abnormally 
terminates. 


seconds 
Specifies the maximum number of seconds that the step can use the processor, in addition 
to any minutes that are specified. The seconds must be a number from 1 through 59. 


1440 
Indicates that the step can use the processor for an unlimited amount of time; 1440 
literally means 24 hours. Code TIME = 1440 for the following reasons: 


@ To obtain job step accounting information. 


e To specify that the system is to allow this step to remain in a continuous wait state 
for more than the installation time limit, which is established through SMF. 
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EXEC: TIME 


Defaults 


If no TIME parameter is specified, JES uses an installation default specified at initialization. 


If 1440 is not specified, SMF uses its current job wait time limit. 


Overrides 


For a JOB statement TIME parameter other than TIME= 1440, the system sets the time limit 
for each step to: 


e The step time limit specified on the EXEC statement TIME parameter or the job time 
remaining after execution of previous job steps, whichever is smaller. 


e Ifno EXEC TIME parameter was specified, (1) the default time limit or (2) the job time 
remaining after execution of previous steps, whichever is smaller. 


On EXEC Statement that Calls a Procedure 


If the EXEC statement calls a cataloged or in-stream procedure, the TIME parameter is added 
to or overrides the TIME parameter on: 


e The EXEC statement named in the procstepname qualifier. The information applies only 
to the named procedure step. The EXEC statement can have as many TIME.procstepname 
parameters as the procedure has steps; each TIME parameter must specify a unique 
procstepname. 


If procstepname is not coded, the TIME parameter applies to the entire procedure and nullifies 
any TIME parameters on EXEC statements in the procedure. 


Time Handling 


How the System Converts the Time Value: The job time limit or the time remaining after 
execution of previous steps in a job is converted by the system to seconds and then rounded to 
the nearest unit, where 1 unit= 1.048576 seconds. Thus a step can begin execution with up to 
one-half unit more or one-half unit less time than expected. If the time remaining for the job is 
less than one-half unit, a step will begin execution with zero time, resulting in an abnormal 
termination. 


Time Checking: Because the system checks the processor time-used field about every 10.5 
seconds, the actual time that a job uses the processor can exceed the specified TIME value by 
up to 10.5 seconds. For example, the system checks the job’s time-used field and finds 0.5 
seconds remaining. Because the system does not again check the job’s time-used field for about 
10.5 seconds, the job can execute for an additional 10.5 seconds and thus exceed the coded 
TIME value by 10 seconds. 
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EXEC: TIME 


Examples of the TIME Parameter 


//STEP1 EXEC PGM=GRYS,TIME=(12,10) 


This statement specifies that the maximum amount of time the step can use the processor is 12 
minutes, 10 seconds. 


//FOUR EXEC PGM=JPLUS,TIME=(,30) 


This statement specifies that the maximum amount of time the step can use the processor is 30 
seconds. 


//INT EXEC PGM=CALC,TIME=5 


This statement specifies that the maximum amount of time the step can use the processor is 5 
minutes. 


//LONG EXEC PGM=INVANL, TIME=1440 
This statement specifies that the step can have unlimited use of the processor. Therefore, the 


step can use the processor and can remain in a wait state for an unspecified period of time, if 
not restricted by the JOB statement TIME parameter. 


//STP4 EXEC PROC=BILLING, TIME.PAID=(45,30) ,TIME.BILL=(112,59) 


This statement calls cataloged or in-stream procedure BILLING. The statement specifies 
different time limits for each of the procedure steps: PAID and BILL. 


For examples of TIME coded on both the JOB and EXEC statements, see “Examples of the 
TIME Parameter on JOB and EXEC Statements” on page 15-40. 
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JOB 


Chapter 15. JOB Statement 


Purpose: Use the JOB statement to mark the beginning of a job and to tell the system how to 
process the job. Also, when jobs are stacked in the input stream, the JOB statement marks the 
end of the preceding job. 


The parameters you can specify for job processing are arranged alphabetically in the following 
pages. 


References: For information about the JES initialization parameters that provide installation 
defaults, see SPL: JES2 Initialization and Tuning and SPL: JES3 Initialization and Tuning. 


Syntax: 


Name Field 


//jobname JOB positional-parameters[,keyword-parameter]...[comments] 


//jobname JOB 


The JOB statement consists of the characters // in columns 1 and 2 and four fields: name, 
operation (JOB), parameter, and comments. Do not code comments if the parameter field is 
blank. 


A JOB statement is required for each job. 


Code a jobname on every JOB statement, as follows: 


Each jobname must be unique. 

The jobname must begin in column 3. 

The jobname is | through 8 alphanumeric or national ($, #, @) characters. If your system 
uses ANSI tapes, the jobname must contain only alphanumeric characters; it must not 
contain national ($, #, @) characters. 


The first character must be alphabetic or national ($, #, @). 


The jobname must be followed by at least one blank. 
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Operation Field 


The operation field consists of the characters JOB and must be preceded and followed by at 
least one blank. It can begin in any column. 


Parameter Field 


A JOB statement has two kinds of parameters: positional and keyword. All parameters are 
optional; however, your installation may require the accounting information parameter and the 
programmer’s name parameter. 


Positional Parameters: A JOB statement can contain two positional parameters. They must 
precede all keyword parameters. You must code the accounting parameter first, followed by 
the programmer’s name parameter. 


POSITIONAL PARAMETERS VALUES PURPOSE | 


({account-number][,accounting-information]...) account-number,accounting-information: Specifies an account number and 

up to 142 characters other accounting information, for- 
matted as required by the installation. 
This parameter may be required by 
the installation. 


See page 15-5 


programmer’s-name programmer’s name: | - 20 characters Identifies the owner of the job. 
This parameter may be required by 
the installation. 

See page 15-26 


Keyword Parameters: A JOB statement can contain the following keyword parameters. You 
can code any of the keyword parameters in any order in the parameter field after the positional 
parameters. 


KEYWORD PARAMETERS VALUES PURPOSE 


ADDRSPC = | VIRT VIRT: virtual (pageable) storage Indicates the type of storage required ) 
REAL REAL: real (nonpageable) storage for the job. 


See page 15-9 


CLASS =jobclass jobclass: A - Z,0-9 Assigns the job to a job class. 
See page 15-11 


COND = ((code,operator)[,(code,operator)]...) code: 0 - 4095 Specifies the return code tests used to 
operator: GT Code from determine whether a job will continue 
G chart on processing or be terminated. 

page 15-14 


See page 15-13 


15-2 MVS/XA JCL Reference 


JOB 


KEYWORD PARAMETERS VALUES | PURPOSE 


GROUP = group-name 


See page 15-15 


MSGCLASS = class 


See page 15-17 


MSGLEVEL = ((statements][,messages]) 


See page 15-19 


NOTIFY = userid 


See page 15-21 


PASSWORD = (password[,new-password]) 


See page 15-23 


PERFORM =n 


See page 15-25 


PRTY = priority 


See page 15-28 


R 
RNC 
NR 
NC 


See page 15-30 


REGION = ] valueK 
valueM 


See page 15-33 


group-name: | - 8 alphanumeric or 
$, #, @ characters 


class: A- Z,0-9 


statements: 
0 Only JOB statement 
1 All JCL and procedure statements 
2 Only JCL statements 
messages: 
0 Only JCL messages 
1 JCL, JES, and operator messages 


userid: 1 - 7 alphanumeric characters 


password or new-password: | - 8 
alphanumeric or $, #, @ characters 


priority (JES2): 0 - 15 
priority (JES3): 0 - 14 


R: restart, checkpoints allowed 
RNC: restart, no checkpoints 

NR: no restart, checkpoints allowed 
NC: no restart, no checkpoints 


valueK: even number, | - 7 digits 
from 1 - 2096128 

valueM: even or odd number, 1 - 4 digits 
from 1 - 2047 


Identifies a group to which a 
RACF-defined user is to be 
connected. 


Assigns the job log to an output class 


Indicates the job control information 
to be printed in the job log. 


Requests that the system send a 
message to a TSO userid when this 
background job completes. 


Identifies the current RACF 
password or specifies a new RACF 
password. 


Specifies the job’s performance group 
which determines the rate at which 
the job has access to the processor, 
storage, and channels. 


JES2: Assigns the job’s queue 
selection priority. 

JES3: Assigns the job’s initiation or 
selection priority in its job class. 


Indicates whether the operator should 
perform automatic step restart, if the 
job fails, and controls whether 
checkpoints are written for CHK PT 
macros or DD statement CHK PT 
parameters. 


Specifies the amount of space in 
kilobytes or megabytes required 
by the job. 
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KEYWORD PARAMETERS VALUES PURPOSE | 


RESTART = *: at first step Specifies restart of a job at the 
. stepname: at named step beginning of a step or from a 
[,checkid] 


stepname 
stepname.procstepname 


procstepname: step is in named procedure | checkpoint within a step. 
checkid: at checkpoint in first or named 
step 


See page 15-35 


TIME= | ({minutes][,seconds]) minutes: 1 - 1439 Specifies the maximum time the job is 
1440 seconds: 1 - 59 to use the processor and requests 

messages giving the time used. 

See page 15-38 


TYPRUN= | COPY COPY: copies job stream to sysout data Requests special job processing. 
HOLD set (JES2 only) 
JCLHOLD HOLD: holds job 
SCAN JCLHOLD: holds job before JCL 
processing (JES2 only) 
SCAN: scans JCL for syntax errors 


See page 15-41 


USER = userid userid: 1 - 7 alphanumeric or $, #, @ Identifies the job’s owner to RACF, 
characters SRM, and other system components. 


See page 15-43 


Comments Field 


The comments field follows the parameter field after at least one intervening blank. If you do } 
not code any parameters on a JOB statement, do not code any comments. 


Location in the JCL 


A JOB statement must be the first statement in each job. JOB statements never appear in 
cataloged or in-stream procedures. 


Examples of JOB Statements ) 
//ALPHA JOB 843,LINLEE,CLASS=F ,MSGCLASS=A,MSGLEVEL=(1,1) 
//LOS JOB ,'J M BUSKIRK',TIME=(4,30) ,MSGCLASS=H ,MSGLEVEL= (2,0) 
//MART JOB 1863,RESTART=STEP4 THIS IS THE THIRD JOB STATEMENT. 
//TRY8 JOB 
//RACF1 JOB  'D83,123',USER=RACO1,GROUP=A27 , PASSWORD=XYY 
//RUNL JOB 'D8306P,D83,B1062J12,S=C','JUDY PERLMAN' ,MSGCLASS=R, 
ve MSGLEVEL=(1,1) ,CLASS=3 ,NOTIFY=D83JCS1, 
Li COND=(8,LT) 
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JOB: Accounting Information 


Accounting Information Parameter 


Parameter Type: Positional, required (according to installation procedures) 


Purpose: Use the accounting information parameter to enter an account number and any other 
accounting information that your installation requires. 


References: For more information on how to add accounting routines, see SPL: System 
Management Facilities. 


Syntax: 


([account-number] [,accounting-information]...) 


Location: Code the accounting information parameter first in the parameter field. 


Omission: If you omit the accounting information parameter but you are coding a 
programmer’s name parameter, code a comma to indicate the omitted parameter. If you 
omit both positional parameters, do not code any commas before the first keyword 
parameter. 


Length: The entire accounting information parameter must not exceed 142 characters: 


e Including any commas, which are considered part of the information. 
e Excluding any enclosing parentheses, which are not considered part of the information. 


Multiple Subparameters: When the accounting information parameter consists of more than 
one subparameter, separate the subparameters by commas and enclose the parameter in 
parentheses or apostrophes. For example, (5438,GROUP6) or ’5438,GROUP6’. If you use 
apostrophes, all information inside the apostrophes is considered one field. 


Special Characters: When a subparameter contains special characters, other than hyphens, 
enclose it in apostrophes and the entire parameter in parentheses or enclose all of the 
parameter in apostrophes. For example, (12A75,,/DEPT/D58’,706) or 
'12A75,DEPT/D58,706’. 


Code each apostrophe or ampersand that is part of the accounting information as two 
consecutive apostrophes or ampersands. For example, code DEPT’DS8 as 
(12A75,’/DEPT’D58’,706) or “12A75,DEPT’’D58,706’. Code 34&251 as ’34&&251’. 


Continuation onto Another Statement: Enclose the accounting information parameter in 
parentheses. End each statement with a comma after a complete subparameter. For 
example: 


//JOB1 JOB (12A75,'DEPT/D58', 
// 706) 
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Subparameter Definition 


account-number J 


Specifies an accounting number, as defined by the installation. 
accounting-information 


Specifies more information, as defined by the installation. For example, your department 
and room numbers. 


Relationship to Other Control Statements 


If you are to provide accounting information for an individual step within a job, code an 
ACCT parameter on the EXEC statement for that step. 


JES2 Accounting Information Format 


Except for the first subparameter, the JES2 accounting information shown in the syntax can, 
alternatively, appear on the JES2 /*JOBPARM statement. If you code the accounting 
information parameter in the JES2 format, JES2 can interpret and use it. 


References: For a discussion of the JES2 scan of the accounting information parameter, see 
SPL: JES2 Initialization and Tuning. 


Syntax: 


(pano,room,time,lines,cards,forms,copies,log,linect) 


Code a comma in place of each omitted subparameter when other subparameters follow. 


Subparameter Definition 


pano 
Specifies the programmer’s accounting number. pano is | through 4 alphanumeric 
characters. 


room 
Specifies the programmer’s room number. room is | through 4 alphanumeric characters. 


time 
Specifies the estimated execution time in minutes. time is 1 through 4 decimal numbers. 
For example, code 30 for 30 minutes. If you omit a time subparameter and a TIME 
parameter on the JES2 /*JOBPARM statement, JES2 uses an installation default specified 
at initialization. If job execution exceeds the time, JES2 sends a message to the operator. 


lines 
Specifies the estimated line count, in thousands of lines, from this job’s sysout data sets. 
lines is 1 through 4 decimal numbers. For example, code 5 for 5000 lines. If you omit 
lines, JES2 uses an installation default specified at initialization. 
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cards 


forms 


JOB: Accounting Information 


Specifies the estimated number of cards JES2 is to punch from this job’s sysout data sets. 
cards is 1 through 4 decimal numbers. If you omit cards, JES2 uses an installation 
default specified at initialization. 


Specifies the forms that JES2 is to use for printing this job’s sysout data sets. forms is 1 
through 4 alphanumeric characters. For example, code 5 for 5-part forms. If you omit 
forms, JES2 uses an installation default specified at initialization. 


copies 


log 


linect 


Specifies the number of times JES2 is to print and/or punch this job’s sysout data sets. 
copies is | through 3 decimal numbers not exceeding an installation-specified limit. The 
maximum is 255. For example, code 2 for two copies. If you omit copies, JES2 assumes 
one copy. 


The copies subparameter is ignored and only one copy is produced if the output class for 
the job log, as specified in the JOB MSGCLASS parameter, or the output class of any of 
the job’s system output data sets is a held class. 


Specifies whether or not JES2 is to print the job log. Code N to request no job log. If 
you code any other character or omit this subparameter, JES2 prints the job log. If your 
installation specified NOLOG for this job’s class during JES2 initialization, JES2 will not 
print a job log. 


Specifies the number of lines JES2 is to print per page for this job’s sysout data sets. 
linect is 1 through 3 decimal numbers. When you send a data set across a network, linect 
cannot exceed 254. When you print the data set locally, linect cannot exceed 255. If you 
omit linect, JES2 uses an installation default specified at initialization. If you code a zero, 
JES2 does not eject to a new page when the number of lines exceeds the installation 
default. 


Invalid Subparameters: Your installation can initialize JES2 to do one of the following if the 
accounting information contains subparameters that are invalid to JES2: 


Ignore the invalid subparameters. 
Terminate the job. In this case, JES2 requires the first two subparameters: pano and room. 


Overrides: A parameter on any of the following statements overrides an equivalent accounting 
information subparameter on the JOB statement: 


JES2 /*JOBPARM statement 
JES2 /*OUTPUT statement 
OUTPUT JCL statement 
DD statement 


Chapter 15. JOB Statement 15-7 


JOB: Accounting Information 


Examples of the Accounting Information Parameter 


//3J0B43 JOB D548-8686 


//JOB44 JOB (D548-8686,'12/8/85' ,PGMBIN) 


Because this statement contains an account-number plus additional accounting-information, 
parentheses are required. 


//JOB45 JOB (CFH1,2G14,15,,,,2) 


This statement shows a JES2 accounting information parameter: programmer’s accounting 
number, CFH1; room number, 2G14; estimated job time, 15 minutes; and copies, 2. 
Parentheses are required. Standard values are assumed for the other JES2 subparameters. 
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JOB: ADDRSPC 


ADDRSPC Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the ADDRSPC parameter to indicate to the system that the job requires virtual 
storage (pageable) or real storage (nonpageable). 


Syntax: 


appRsP¢= |Vzaq| 


REAL 


Subparameter Definition 


Defaults 


Overrides 


VIRT 
Requests virtual storage. The system can page the job. 


REAL 
Requests real storage. The system cannot page the job and must place each step of the 
job in real storage. 


If no ADDRSPC parameter is specified, the default is VIRT. 


The JOB statement ADDRSPC parameter applies to all steps of the job and overrides any 
EXEC statement ADDRSPC parameters. 


Code EXEC statement ADDRSPC parameters when each job step requires different types of 
storage. The system uses an EXEC statement ADDRSPC parameter only when no ADDRSPC 
parameter is on the JOB statement and only during the job step. 


Relationship to the JOB REGION Parameter 


When ADDRSPC= REAL: Code a REGION parameter to specify how much real storage the 
job needs. If you omit the REGION parameter, the system uses an installation default 
specified at JES initialization. 


When ADDRSPC= VIRT or ADDRSPC is Omitted: Code a REGION parameter to specify 


how much virtual storage the job needs. If you omit the REGION parameter, the system uses 
an installation default specified at JES initialization. 
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Examples of the ADDRSPC Parameter 


//PEH JOB’ ,BAKER,ADDRSPC=VIRT 


The ADDRSPC parameter requests virtual (pageable) storage. The space available to the job is 
the installation-specified default. 


//DEB JOB’ ,ERIC,ADDRSPC=REAL , REGION=100K 


The ADDRSPC parameter requests real (nonpageable) storage. The REGION parameter 
specifies 100K of storage for the job. 
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JOB: CLASS 


CLASS Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the CLASS parameter to assign the job to a class. The class you should request 
depends on the characteristics of the job and your installation’s rules for assigning classes. 


In a JES2 system, the assigned job class can affect whether or how a job is executed. A job 
class can be defined during JES2 initialization as: 


e Held. The system holds any job assigned to this class until the operator releases it. 
e To be copied only. The system copies the input stream for the job directly to a sysout data 
set and schedules the sysout data set for output processing. The system does not execute 


the job or allocate devices. 


e To be scanned for job control statement syntax errors. The system does not execute the job 
or allocate devices. 


Syntax: 


CLASS=jobclass 


Subparameter Definition 


jobclass 
Identifies the class for the job. The jobclass is one character, A through Z or 0 through 9, 
and must be a valid class specified at JES initialization. 


Defaults 

If you do not specify a class, JES uses the installation default specified at initialization, as 

follows: 

e Ina JES2 system, the default is based on the source of the job: The system makes the job’s 
class the same as the installation-specified default class for the particular card reader, work 
station, or time-sharing user that submitted the job. 

e Ina JES3 system, the default is an installation-defined standard default class. 

Overrides 


A JES3 //*MAIN statement CLASS parameter overrides a JOB statement CLASS parameter. 
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Relationship to Other Control Statements 


In JES3 systems, you can also code a CLASS parameter on a JES3 //*MAIN statement. 
Example of the CLASS Parameter 


//SETUP JOB 1249,SMITH,CLASS=M 


This statement assigns the job to class M. 
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JOB: COND 


COND Parameter 


C 


Parameter Type: Keyword, optional 


Purpose: Use the COND parameter to specify the return code tests the system uses to 
determine whether a job will continue processing. Before and after each job step is executed, 
the system performs the COND parameter tests against the return codes from completed job 
steps. If none of these tests is satisfied, the system executes the job step; if any test is satisfied, 
the system bypasses all remaining job steps and terminates the job. 


The tests are made against return codes from the current execution of the job. A step bypassed 
because of an EXEC statement COND parameter does not produce a return code. 


Bypassing a step because of a return code test is not the same as abnormally terminating the 
step. The system abnormally terminates a step following an error so serious that it prevents 
successful execution. In contrast, bypassing of a step is merely its omission. 


c Note: In both JES2 and JES3 systems, a JOB COND parameter determines if steps are 
executed or bypassed. However, JES3 processes all jobs as though each step will execute; 


therefore, JES3 allocates devices for steps that are bypassed. 


Syntax: 


COND=(code,operator) 
COND=( (code,operator)[,(code,operator)]...) 


One return code test is: (code,operator) 
You can omit the outer parentheses if you code only one return code test. 
Specify up to eight return code tests for a job. 


Subparameter Definition 


: | code 


Specifies a number that the system compares to the return code from each job step. code 
is a decimal number from 0 through 4095. 


Note: Specifying a decimal number greater than 4095 could result in invalid return code 
testing or invalid return codes in messages. 


operator 
Specifies the type of comparison to be made to the return code. If the specified test is 
true, the system bypasses all remaining job steps. Use the chart on this page to select the 
correct operator. Operators and their meanings are: 


Operator Meaning 


GT Greater than 

GE Greater than or equal to 
EQ Equal to 

NE Not equal to 

LT Less than 

LE Less than or equal to 
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Overrides 


If you code the COND parameter on the JOB statement and on one or more of the job’s EXEC 
statements, and if a return code test on the JOB statement is satisfied, the job terminates. In 
this case, the system ignores any EXEC statement COND parameters. 


If the tests on the JOB statement are not satisfied, the system then performs the return code 
tests on the EXEC statement. If an EXEC return code test is satisfied, the step is bypassed. 


Summary of COND Parameters 


Test in COND Parameter 


COND = (code,GT) 
COND = (code,GE) 


COND = (code,EQ) 


COND = (code,LT) 
COND = (code,LE) 
COND = (code,NE) 


Figure 15-1. 


Return Code (RC) from Just Completed Step 


RC < code 


RC < code 


RC = code 


RC > code 
RC > code 


RC = code 


Continuation or Termination of the Job Based on COND Parameter 


Examples of the COND Parameter 


//TYPE JOB (611,402) ,BOURNE,COND=(7,LT) 

The COND parameter specifies that if 7 is less than the return code, the system terminates the 
job. Any return code less than or equal to 7 allows the job to continue. 

//TEST JOB 501,BAXTER,COND=((20,GE),(30,LT) ) 

The COND parameter specifies that if 20 is greater than or equal to the return code or if 30 is 


less than the return code, the system terminates the job. Any code of 21 through 30 allows the 
job to continue. 
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JOB: GROUP 


GROUP Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the GROUP parameter to specify a RACF-defined group to which a 
RACF-defined user is to be connected. RACF places each RACF-defined user in a default 
group; the GROUP parameter is needed only to specify a group other than a user’s default 
group. 


If the installation contains the feature for propagation of the user and group identification, the 
USER, the PASSWORD, and, optionally, the GROUP parameters are required on JOB 
statements only for the following: 


e Batch jobs submitted through an input stream, such as a card reader, (1) if the job requires 
access to RACF-protected resources or (2) if the installation requires that all jobs have 
RACF identification. 


@ Jobs submitted by one TSO user for another user. In this case, the JOB statement must 
specify the other user’s userid and password. The group id is optional. 


@ Jobs that execute at another network node that uses RACF protection. 
Otherwise, the USER, PASSWORD, and GROUP parameters can be omitted from JOB 
statements. RACF uses the userid, password, and default group id of the submitting TSO user 


or job. 


References: For more information on RACF-protected facilities, see Resource Access Control 
Facility (RACF) General Information Manual. 


Syntax: 


GROUP=group-name 


Subparameter Definition 


Defaults 


group-name 
Identifies the group with which the system is to associate the user. group-name is 1 
through 8 alphanumeric or national ($, #, @) characters. The first character must be 
alphabetic or national ($, #, @). 


If you do not code the GROUP parameter, but do code the USER and PASSWORD 
parameters, the system assigns the RACF default group name associated with the specified 
userid. However, the default group name is not passed to JES and thus is not available to JES 
installation exits. 
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Relationship to Other Parameters 


If the JOB statement contains a GROUP parameter, the statement must also contain USER J 
and PASSWORD parameters. 


Example of the GROUP Parameter 


//TEST JOB 'D83,123456' ,GROUP=MYGROUP , USER=MYNAME , PASSWORD=ABC 


This statement requests that the system connect RACF-defined user MYNAME to the group 
named MYGROUP for the duration of the job. 
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JOB: MSGCLASS 


MSGCLASS Parameter 


C Parameter Type: Keyword, optional 


Purpose: Use the MSGCLASS parameter to assign the job log to an output class. The job log 
is a record of job-related information for the programmer. Depending on the JOB statement 
MSGLEVEL parameter, the job log can consist of: 


e Only the JOB statement. 

e All job control statements. 

e In-stream and cataloged procedure statements. 
e Job control statement messages. 

e JES and operator messages about the job. 
Syntax: 


( MSGCLASS=class 


Subparameter Definition 


class 
Identifies the output class for the job log. The class is one character, A through Z or 0 
through 9, and must be a valid output class specified at JES initialization. 


Defaults 


The default is based on the source of the job: The system places the job log in the same output 
class as the installation-specified default class for the particular card reader, work station, or 
time-sharing user that submitted the job. The installation default is specified at JES 
initialization. 


Cc Significance of Output Classes 


To print the job log and any output data sets on the same output listing, code one of the 
following: 


e The same output class in the DD SYSOUT parameter as in the JOB MSGCLASS 
parameter. 


e DD SYSOUT = * to default to the JOB MSGCLASS output class. 
e DD SYSOUT =(,) to default to one of the following: 

1. The CLASS parameter in an explicitly or implicitly referenced OUTPUT JCL 
statement. In this case, the OUTPUT JCL CLASS parameter should specify the same 
output class as the JOB MSGCLASS parameter. 

( 2. The JOB MSGCLASS output class, if no OUTPUT JCL statement is referenced or if 
the referenced OUTPUT JCL statement contains CLASS =*. 
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Examples of the MSGCLASS Parameter 


//EXMP1 JOB ,GEORGE,MSGCLASS=F 
In this example, the JOB statement specifies output class F for the job log. 
//EXMP2 JOB ,MENTLE,MSGLEVEL=(2,0) 


This JOB statement does not specify an output class. In this case, the output class defaults to 
the installation default output class for the device from which the job was submitted. 


//A1403 JOB ,BLACK,MSGCLASS=L 
//STEP1 EXEC PGM=PRINT 
//OUTDD1 DD SYSOUT=L 


In this example, the JOB statement and sysout DD statement OUTDD1 both specify the same 
output class. Consequently, the job log and data set OUTDD1 are written on the same output 
listing. 


//B209 JOB  ,WHITE,MSGCLASS=M 
//STEPA EXEC PGM=PRINT 
//OUTDDX DD SYSOUT=* 


In this example, the JOB statement specifies that the system route the job log to output class 
M. The system also routes sysout data set OUTDDX to class M because SYSOUT =* is 
specified. 
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JOB: MSGLEVEL 


MSGLEVEL Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the MSGLEVEL parameter to control listing of the job log. You can request 
that the system print the following: 


@ Only the JOB statement. 


e All job control statements in the input stream, that is, all JCL statements and JES2 or JES3 
statements. 


e@ In-stream and cataloged procedure statements for any procedure a job step calls. 
@ Messages about job control statements. 


e JES and operator messages about the job’s processing: allocation of devices and volumes, 
execution and termination of job steps and the job, and disposition of data sets. 


Syntax: 


MSGLEVEL=( [statements] [,messages] ) 


You can omit the parentheses if you code only the first subparameter. 


Subparameter Definition 


statements 

Indicates which job control statements the system is to print in the job log. statements is 

one of the following numbers: 

0 The system prints only the JOB statement. 

1 The system prints all JCL statements, JES2 or JES3 control statements, the procedure 
statements, and IEF653I messages, which give the values assigned to symbolic 
parameters in the procedure statements. 

2 The system prints only JCL statements and JES2 or JES3 control statements. 

messages 

Indicates which messages the system is to print in the job log. messages is one of the 


following numbers: 


0 The system prints only JCL messages. It prints JES and operator messages only if the 
job abnormally terminates, and prints SMS messages only if SMS fails the job. 


1 The system prints JCL, JES, operator, and SMS messages. 
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Defaults 


If you do not code the MSGLEVEL parameter, JES uses an installation default specified at 
initialization. 


Examples of the MSGLEVEL Parameter 


//EXMP3 JOB ,GEORGE,MSGLEVEL=(2,1) 


In this example, the JOB statement requests that the system print JCL statements, JCL 
messages, JES and operator messages, and SMS messages. 


//EXMP4 JOB ,MENTLE,MSGLEVEL=0 


In this example, the JOB statement requests that the system print only the JOB statement and 
that JES is to use the installation default for messages. 


//EXMP5 JOB ,MIKE,MSGLEVEL=(,0) 


In this example, the JOB statement requests that JES use the installation default for printing 
JCL statements and the system is not to print JES and operator messages unless the job 
abnormally terminates. SMS messages are printed only if SMS fails the job. 
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JOB: NOTIFY 


NOTIFY Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the NOTIFY parameter to request that the system send a message to your TSO 
userid or another TSO userid when this background job completes processing. 


Syntax: 


NOTIFY=userid 


Subparameter Definition 


userid 
Identifies the user that the system is to notify. The userid is 1 through 7 alphanumeric 
characters and must be a valid TSO userid. 


Relationship to JES2 /*JOBPARM SYSAFF Parameter 


If you submit a TSO job with a JOB statement NOTIFY parameter or the job includes a JES2 
/*NOTIFY statement, do not specify IND in a JES2 /*JOBPARM SYSAFF parameter; the 
IND subparameter would change the mode of the job. This change would be invalid because 
the mode of the job must match the mode of the system at which the job is submitted. 


Receiving Notification of Job Completion 


In a JES2 System: If you are logged on to the member of the JES2 multi-access spool from 
which you submitted the job, the system immediately notifies you when the job completes. If 
you are not logged on, the system saves the message until you log on to the member from 
which you originally submitted the job. 


In a JES3 System: If you are logged on, the system immediately notifies you when the job 
completes. If you are not logged on, the system saves the message until you log on to the 
system from which you originally submitted the job. 


To receive notification that a job you submitted through batch processing has completed, code 
an ACMAIN parameter on a JES3 //*MAIN statement in addition to the JOB statement 
NOTIFY parameter. The ACMAIN parameter names the processor on which your TSO system 
is running. 


If a //*ROUTE or XMIT JCL statement follows the JOB statement, you may not be notified 
when the transmitted job completes. 
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Example of the NOTIFY Parameter 


//SIGN JOB- ,JEEVES ,NOTIFY=POK1 


When the job SIGN completes processing, the system sends a message to userid POK1. 


15-22 MVS/XA JCL Reference 


JOB: PASSWORD 


PASSWORD Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the PASSWORD parameter to identify a current RACF password or specify a 
new RACF password. You can specify a new password at any time and must specify a new 
password when your current one expires. 


If the installation specified JES early user verification in its RACF options and contains the 
user exit routine needed to verify the password, a new password specified in the PASSWORD 
parameter takes effect when the job is read in. The new password takes effect even if the job is 
held for execution later and may take effect even if the job fails because of JCL errors. When 
changing the password, other jobs that use the new or old password may fail, depending on 
when their passwords are verified. 


If the installation contains the feature for propagation of the user and group identification, the 
USER, the PASSWORD, and, optionally, the GROUP parameters are required on JOB 
statements only for the following: 


@ Batch jobs submitted through an input stream, such as a card reader, (1) if the job requires 
access to RACF-protected resources or (2) if the installation requires that all jobs have 
RACF identification. 


e Jobs submitted by one TSO user for another user. In this case, the JOB statement must 
specify the other user’s userid and password. The group id is optional. 


@ Jobs that execute at another network node that uses RACF protection. 
Otherwise, the USER, PASSWORD, and GROUP parameters can be omitted from JOB 
statements. RACF uses the userid, password, and default group id of the submitting TSO user 


or job. 


References: For more information on using RACF-protected facilities, see Resource Access 
Control Facility (RACF) General Information Manual. 


Syntax: 


PASSWORD= (password[,new-password] ) 


@e You can omit the parentheses if you code only the first subparameter. 


e The PASSWORD parameter must be on the first statement if the JOB statement is 
continued. 
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Subparameter Definition 
password 
Specifies the user’s current RACF password. The password is | through 8 alphanumeric 
or national ($, #, @) characters. 
nhew-password 
Specifies the user’s new RACF password. The new-password is | through 8 alphanumeric 


or national ($, #, @) characters. The installation’s security administrator can impose 
additional restrictions on passwords; follow your installation’s rules. 


Relationship to Other Parameters 
If the installation does not contain the user and group identification propagation feature: 


@ Code a PASSWORD parameter when coding a USER or GROUP parameter on a JOB 
statement. 


@ Code a USER parameter when coding a PASSWORD parameter. 
Examples of the PASSWORD Parameter 


//TEST1 JOB 'D83,123456' ,PASSWORD=ABCDE , USER=MYNAME 


This JOB statement identifies ABCDE as the current password for the RACF user. 


//TEST2 JOB 'D83,123456' ,PASSWORD=(BCH,A12) ,USER=RAC1 ,GROUP=GRP1 


This JOB statement requests that the system change the RACF password from BCH to A12. 
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JOB: PERFORM 


PERFORM Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the PERFORM parameter to specify the performance group for the job. The 
installation-defined performance groups determine the rate at which associated jobs have access 
to the processor, storage, and channels. 


Syntax: 


PERFORM=n 


Subparameter Definition 


n 
Requests a performance group. The nis a number from 1 through 999 and must identify 
a performance group that has been defined by your installation. The specified 
performance group should be appropriate for your job type according to your 
installation’s rules. 


Defaults 


If no PERFORM parameter is specified or if the specified PERFORM number fails validity 
checks, the system uses an installation default specified at initialization. If the installation did 
not specify a default, the system uses a built-in default: 


Default Use 


1 For non-TSO jobs 
2 For TSO sessions 


See SPL: Initialization and Tuning for details. 


Overrides 


A JOB statement PERFORM parameter applies to all steps of the job and overrides any EXEC 
statement PERFORM parameters. 


Code EXEC statement PERFORM parameters when each job step executes in a different 
performance group. The system uses an EXEC statement PERFORM parameter only when no 
PERFORM parameter is on the JOB statement and only during the job step. 


Example of the PERFORM Parameter 


//STEP1 JOB’ ,MARLA,CLASS=D,PERFORM=25 


In this example, CLASS =D determines the class in which the system will execute the job. 
Once in the system, the job will run in performance group 25. The installation must have 
defined the significance of this performance group. 
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Programmer’s Name Parameter 


Parameter Type: Positional, required (according to installation procedures) 


Purpose: Use the programmer’s name parameter to identify the person or group responsible 
for a job. 


Syntax: 


programmer 's-name 


Location: Place the programmer’s name parameter immediately after the accounting 
information parameter and before all keyword parameters. 


Omission: Do not code a comma to indicate the absence of the programmer’s name 
parameter. For example: 


//JOBA JOB 'D58/706',MSGCLASS=A 
Special Characters: Enclose the programmer’s name in apostrophes when: 


® The name contains special characters, other than hyphens, leading periods, or embedded 
periods. For example: 


//JOBB JOB ,S-M-TU 

//JOBC JOB ,.ABC 

//JOBD JOB ,P.F.M 

//JOBE JOB ,'BUILD/PAUL' 
//JOBF JOB ,'MAE BIRDSALL' 


The last character of the name is a period. For example: 


//JOBG JOB ,'A.B.C.! 


Code each apostrophe that 1s part of the name as two consecutive apostrophes. For 
example, code O'/DONNELL as ’(O” DONNELVL’. ) 


Parameter Definition 


programmer’ s-name 
Identifies the job’s owner. The name must not exceed 20 characters, including all special 
characters. 
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JOB: Programmer’s Name 


Examples of the Programmer’s Name Parameter 


//APP JOB ,G.M.HILL 


This JOB statement specifies a programmer’s name with no accounting information. The 
leading comma may be optional; check with your installation. 


//DELTA JOB 'T.O''NEILL' 
The programmer’s name contains special characters. The installation requires no accounting 
information. The imbedded apostrophe is coded as two consecutive apostrophes; the entire 


name must be enclosed in apostrophes. 


//#308 JOB (846349,GROUP12) ,MATTHEW 


This JOB statement specifies an account number, additional accounting information, and a 
programmer’s name. 


//JOBA JOB 'DEPT. 15E' 


This installation requires the department number in the programmer’s name parameter. 
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PRTY Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the PRTY parameter to assign a selection priority to your job. Within a JES2 
job class or a JES3 job class group, the system selects jobs for execution in order by priority. A 
job with a higher priority is selected for execution sooner; jobs with the same priority are 
selected on a first-in first-out basis. 


Note: Depending on the JES2 initialization options in use at your installation, JES2 may 
ignore the PRTY parameter. 


References: For more information about priority, see SPL: JES2 Initialization and Tuning. 


Syntax: 


PRTY=priority } 


Subparameter Definition 


priority 
Requests a priority for the job. The priority is a number from 0 through 15 for JES2 and 
from 0 through 14 for JES3. The highest priority is 15 or 14. 


Follow your installation’s rules in coding a priority. 


Defaults 
JES2 determines the job priority from the following, in override order: 
1. A JES2 /*PRIORITY statement. 
2. A PRTY parameter on the JOB statement. J 


3. A value calculated from the accounting information on a JES2 /*JOBPARM statement or 
the JOB statement. 


4. An installation default specified at JES2 initialization. 
JES3 determines the job priority from the following, in override order: 


1. A PRTY parameter on the JOB statement. If the specified priority is invalid, JES3 issues 
an error message. 


2. An installation default specified at JES3 initialization. 
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Overrides 


To assign a different priority to a particular step in the job, code the DPRTY parameter on the 
EXEC statement for that step. The job’s priority applies to any step without a DPRTY 
parameter. 


Example of the PRTY Parameter 


//JOBA JOB 1,'JIM WEBSTER' ,PRTY=12 


This job has a priority of 12. 
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RD Parameter 


Parameter Type: Keyword, optional 
Purpose: Use the RD (restart definition) parameter to: 
@ Request that the operator perform automatic step restart if the job fails. 


e Suppress, partially or totally, the action of the assembler language CHKPT macro 
instruction or the DD statement CHKPT parameter. 


The system can perform automatic restart only if all of the following are true: 


The JOB or EXEC statement contains RD=R or RD=RNC. 

The step to be restarted returned a completion code that indicated no error in the step. 
The operator authorizes a restart. 

The job has a job journal. 


A job journal is a sequential data set that contains job-related control blocks needed for restart. 
For JES2, specify a job journal by one of the following: 


e An installation option during JES2 initialization. 
e RD=R or RD=RNC on either the JOB statement or any one EXEC statement in the job. 


For JES3, specify a job journal by one of the following: 


e An installation option during JES3 initialization. 
e RD=R or RD=RNC on either the JOB statement or any one EXEC statement in the job. 
e JOURNAL= YES on a JES3 //*MAIN statement in the job. 


References: For detailed information on deferred checkpoint restart, see Checkpoint/Restart 
User's Guide. 


Syntax: 
RD= (R Jd 
RNC 
NR 
NC 
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Subparameter Definition 


R (Restart, Checkpoints Allowed) 
Indicates that the operator is to perform automatic step restart if the job fails. 


RD=R does not suppress checkpoint restarts: 


e Ifthe processing program executed in a job step does not include a CHKPT macro 
instruction, RD=R allows the system to restart execution at the beginning of the 
abnormally terminated step. 


e Ifthe program includes a CHKPT macro instruction, RD=R allows the system to 


restart execution at the beginning of the step, if the step abnormally terminates before 
the CHK PT macro instruction is executed. 


e If the step abnormally terminates after the CHKPT macro instruction is executed, 
only checkpoint restart can occur. If you cancel the affects of the CHKPT macro 
instruction before the system performs a checkpoint restart, the request for automatic 
step restart is again in effect. 


RNC (Restart, No Checkpoints) 
Indicates that the operator is to perform automatic step restart if the job fails. 


RD =RNC suppresses automatic and deferred checkpoint restarts. It suppresses: 

@e Any CHKPT macro instruction in the processing program: That is, the operator is 
not to perform an automatic checkpoint restart, and the system is not to perform a 
deferred checkpoint restart if the job is resubmitted. 

e The DD statement CHKPT parameter. 


@ The checkpoint at end-of-volume (EOV) facility. 


NR (No Automatic Restart, Checkpoints Allowed) 
Indicates that the operator is not to perform automatic step restart if the job fails. 


RD=NR suppresses automatic checkpoint restart but permits deferred checkpoint 
restarts. It permits: 


e A CHKPT macro instruction to establish a checkpoint. 


e The job to be resubmitted for restart at the checkpoint. On the JOB statement when 
resubmitting the job, specify the checkpoint in the RESTART parameter. 


If the system fails, RD=NR does not prevent the job from restarting. 


NC (No Automatic Restart, No Checkpoints) 
Indicates that the operator is not to perform automatic step restart if the job fails. 


RD=NC suppresses automatic and deferred checkpoint restarts. It suppresses: 
e Any CHKPT macro instruction in the processing program. 


e The DD statement CHKPT parameter. 
e The checkpoint at EOV facility. 
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Defaults 


Overrides 


If you do not code the RD parameter, the system uses the installation default from the job’s job 


class specified at initialization. 


A JOB statement RD parameter applies to all steps of the job and overrides any EXEC 
statement RD parameters. 


Code EXEC statement RD parameters when each job step requires different restart types. The 


system uses an EXEC statement RD parameter only when no RD parameter is on the JOB 
statement and only during the job step. 


Relationship to Other Control Statements 


RD=NC or RD=RNC suppresses the action of the DD statement CHKPT parameter. 


Examples of the RD Parameter 


//JILL JOB 333,TOM,RD=R 

RD=R specifies that the operator is to perform automatic step restart if the job fails. 
//TRY56 JOB 333,DICK,RD=RNC 

RD=RNC specifies that, if the job fails, the operator is to perform automatic step restart 
beginning with the step that abnormally terminates. RD=RNC suppresses automatic and 


deferred checkpoint restarts. 


//PASS JOB (721,994) ,HARRY,RD=NR 


RD=NR specifies that the operator is not to perform automatic step restart or automatic 


checkpoint restart. However, a CHKPT macro instruction can establish checkpoints to be used 


later for a deferred restart. 
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REGION Parameter 


Parameter Type: Keyword, optional 
Purpose: Use the REGION parameter to specify the amount of space that the job requires. 


The specified or default region size sets an upper boundary to limit region size for 
variable-length GETMAINs. The system uses the upper boundary for variable-length 
GETMAINs as long as the region still has available at least the minimum amount of storage 
requested. 


In addition, the IBM- or installation-supplied routine IEALIMIT or IEFUSI uses the region 
size to establish a second limiting value. The system uses this second value to limit: 


e Fixed-length GETMAINSs. 


@ Variable-length GETMAINSs when the space remaining in the region is less than the 
minimum requested. 


If the minimum requested length for variable-length GETMAINs or the amount requested for a 
fixed-length GETMAIN exceeds this second value, the job or job step abnormally terminates. 


Specifying a Region Size Value: If your installation does not change the IBM-supplied default 
limits in the IEALIMIT and/or IEFUSI exit routine modules, then specifying various values for 
the region size have the following results: 


e A value equal to OK or OM -- gives the job all the storage available below and above 16 
megabytes. The resulting size of the region below and above 16 megabytes is unpredictable. 


e A value greater than OK or OM and less than or equal to 16384K or 16M -- establishes the 
size of the private area below 16 megabytes. If the region size specified is not available 
below 16 megabytes, the job abnormally terminates. The extended region size is the default 
value of 32 megabytes. 


e A value greater than 16384K or 16M and less than or equal to 32768K or 32M -- gives the 
job all the storage available below 16 megabytes. The resulting size of the region below 16 
megabytes is unpredictable. The extended region size is the default value of 32 megabytes. 


e A value greater than 32768K or 32M and less than or equal to 2096128K or 2047M -- gives 
the job all the storage available below 16 megabytes. The resulting size of the region below 
16 megabytes is unpredictable. The extended region size is the specified value. If the 
region size specified is not available above 16 megabytes, the job abnormally terminates. 


References: For more information on the region size, see SPL: System Modifications. For 
more information on region size with checkpoint/restart jobs, see Checkpoint/Restart User's 
Guide. 


Syntax: 


REGION= |JvalueK 


valueM 
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Subparameter Definition 


valueK 2 


Specifies the required storage in kilobytes (1 kilobyte = 1024 bytes). The value is 1 
through 7 decimal numbers, from | through 2096128. Code an even number. For 
example, REGION = 66F.. If you code an odd number, the system treats it as the next 
highest even number. 


valueM 
Specifies the required storage in megabytes (1 megabyte = 1024 kilobytes). The value is 


1 through 4 decimal numbers, from 1 through 2047. Code either an even or odd number. 
For example, REGION =3M. 


Defaults 

If no REGION parameter is specified, the system uses an installation default specified at JES 

initialization. | ; 
Overrides 


A JOB statement REGION parameter applies to all steps of the job and overrides any EXEC 
statement REGION parameters. 


Code EXEC statement REGION parameters when each job step requires a different region size. 


The system uses an EXEC statement REGION parameter only when no REGION parameter is 
on the JOB statement and only during the job step. ) 


Relationship to the JOB ADDRSPC Parameter 


When ADDRSPC= REAL: Code a REGION parameter to specify how much real storage the 
job needs. If you omit the REGION parameter, the system uses the default. 


When ADDRSPC = VIRT or ADDRSPC is Omitted: Code a REGION parameter to specify 
how much virtual storage the job needs. If you omit the REGION parameter, the system uses 


the default. ) 


Examples of the REGION Parameter 


//ACCT1 JOB A23,SMITH, REGION=100K, ADDRSPC=REAL 
This JOB statement indicates that the job requires 100K of real storage. 
//ACCT4 JOB 175,FRED,REGION=250K 


This JOB statement indicates that the job requires 250K of virtual storage. When the 
ADDRSPC parameter is omitted, the system defaults to ADDRSPC=VIRT. 
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RESTART Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the RESTART parameter to restart a job. You can specify that the system 
perform either of two restarts: 


e Deferred step restart, which is a restart at the beginning of a job step. 


e@ Deferred checkpoint restart, which is a restart from a checkpoint taken during step 
execution by a CHKPT macro instruction. 


References: For detailed information on the deferred checkpoint restart, see Checkpoint/Restart 
User's Guide. 


Syntax: 


RESTART=| | * 
stepname [,checkid] 


stepname.procstepname 


You can omit the parentheses if you code only the first subparameter. 


Subparameter Definition 


¥ 


Indicates that the system is to restart execution (1) at the beginning of or within the first 
job step or (2), if the first job step calls a cataloged or in-stream procedure, at the 
beginning of or within the first procedure step. 


stepname 
Indicates that the system is to restart execution at the beginning of or within a job step. 
If stepname refers to an EXEC statement that invokes a procedure, the step name of the 
step within the procedure must also be specified. 


stepname.procstepname 
Indicates that the system is to restart execution at the beginning of or within a step of a 
cataloged procedure. Stepname identifies the EXEC statement of the job step that calls 
the procedure; procstepname identifies the EXEC statement of the procedure step. 


checkid 
Specifies the name of the checkpoint at which the system is to restart execution. This 
checkpoint must be in the job step specified in the first subparameter. 
Omit checkid to request restart at the beginning of the specified job step. 
When the name contains special characters, enclose it in apostrophes. Code each 


apostrophe that is part of the name as two consecutive apostrophes. For example, code 
CHPT’! as ’CHPT’’1’. 
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Relationship to Other Control Statements 


When the system is to restart execution in a job step, place a SYSCHK DD statement 
immediately following the JOB statement. The SYSCHK DD statement defines the data set on 
which the system entered the checkpoint for the step being restarted. 


When preparing for a deferred checkpoint, code the DISP abnormal termination disposition 
subparameter in the step’s DD statements as follows: 


@e KEEP, to keep all data sets that the restart step is to use. 


e CATLG, to catalog all data sets that you are passing from steps preceding the restart step 
to steps following the restart step. 


In JES2 systems, you can also use the RESTART parameter on the /*JOBPARM control 
statement. 


In JES3 systems, use can also use the FAILURE parameter on the //*MAIN control statement. 


Cautions when Coding the RESTART Parameter 
Before resubmitting a job: 
@ Check all backward references to steps before the restart step. Eliminate all backward 


references in EXEC statement PGM parameters and DD statement VOLUME= REF 
parameters. 


e Review all EXEC statement COND parameters. If any of the COND parameters reference 
a step before the restart step, be aware that the system ignores the return code tests for 
those steps. 


Generation Data Sets in Restarted Jobs 


In the restart step or following steps, do not use the original relative generation numbers to 
refer to generation data sets that were created and cataloged before the restart step. Instead, 
refer to a generation data set by its present relative generation number. ) 


For example, if the last generation data set created and cataloged was assigned a generation 
number of +2, refer to it as 0 in the restart step and following steps. If generation data set +1 
was also created and cataloged, refer to it as -1. 


If generation data sets created in the restart step were kept instead of cataloged, that is, 
DISP = (NEW,CATLG,KEEP) was coded, then refer to them by the same relative generation 
numbers used to create them. 
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Examples of the RESTART Parameter 


//LINES JOB '1/17/85',RESTART=COUNT 


This JOB statement indicates that the system is to restart execution at the beginning of the job 
step named COUNT. 


//@LOC5 JOB '4/11/86' ,RESTART=(PROCESS ,CHKPT3) 
//SYSCHK DD DSNAME=CHK , UNIT=3330,DISP=OLD 


The JOB statement indicates that the system is to restart execution at checkpoint CHKPT3 in 
job step PROCESS. The SYSCHK DD statement must follow the JOB statement; it defines 
the data set on which the system wrote checkpoint CHKPT3. 


//WORK JOB’ ,PORTER,RESTART=(*,CKPT2) 
//SYSCHK DD DSNAME=CHKPT, UNIT=3330,DISP=OLD 


The JOB statement indicates that the system is to restart execution at checkpoint CKPT2 in the 
first job step. The SYSCHK DD statement defines the data set on which the system wrote 
checkpoint CKPT2. 


//CLIP5 JOB’ ,COLLINS, RESTART=(PAY.WEEKLY , CHECK8) 
//SYSCHK DD DSNAME=CHKPT,UNIT=3350,DISP=OLD 


The JOB statement indicates that the system is to restart execution at checkpoint CHECK8 in 
procedure step WEEKLY. PAY is the name field on the EXEC statement that calls the 
cataloged procedure that contains procedure step WEEKLY. The SYSCHK DD statement 
defines the data set on which the system wrote checkpoint CHECK8. 
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TIME Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the TIME parameter to specify the maximum length of time that a job is to use 
the processor and to find out through messages how much processor time the job used. 


The system terminates a job that exceeds the specified time limit unless a user exit routine 
extends the time. The exit routine is established through System Management Facilities (SMF). 


References: See SPL: System Management Facilities (SMF). 


Syntax: 


TIME= |( [minutes] [,seconds] ) 
1440 


You can omit the parentheses if you code only 1440 or the processor time in minutes. 


Subparameter Definition 


minutes 
Specifies the maximum number of minutes the job can use the processor. The minutes 
must be a number from 1 through 1439. 


Do not code TIME=0 or TIME =(,) on the JOB statement. The results are 
unpredictable. 


seconds 
Specifies the maximum number of seconds that the job can use the processor, in addition 
to any minutes that are specified. The seconds must be a number from | through 59. 
1440 
Indicates that the job can use the processor for an unlimited amount of time; 1440 
literally means 24 hours. Code TIME= 1440 for the following reasons: 


e To obtain job accounting information. 


e To specify that the system is to allow any of the job’s steps to remain in a continuous 
wait state for more than the installation time limit, which is established through SMF. 


Defaults 


If no JOB TIME parameter is specified, JES terminates the job when a job step exceeds its 
maximum time limit. 


If 1440 is not specified, SMF uses its current job wait time limit. 
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Overrides 


For a JOB statement TIME parameter other than TIME= 1440, the system sets the time limit 
for each step to: 


@ The step time limit specified on the EXEC statement TIME parameter or the job time 
remaining after execution of previous job steps, whichever is smaller. 


e If no EXEC TIME parameter was specified, (1) the default time limit or (2) the job time 
remaining after execution of previous steps, whichever is smaller. 


Time Handling 


How the System Converts the Time Value: The job time limit or the time remaining after 
execution of previous steps in a job is converted by the system to seconds and then rounded to 
the nearest unit, where 1 unit= 1.048576 seconds. Thus, a step can begin execution with up to 
one-half unit more or one-half unit less time than expected. If the time remaining for the job is 
less than one-half unit, a step will begin execution with zero time, resulting in an abnormal 
termination. 


Time Checking: Because the system checks the processor time-used field about every 10.5 
seconds, the actual time that a job uses the processor can exceed the specified TIME value by 
up to 10.5 seconds. For example, the system checks the job’s time-used field and finds 0.5 
seconds remaining. Because the system does not again check the job’s time-used field for about 


10.5 seconds, the job can execute for an additional 10.5 seconds and thus exceed the coded 
TIME value by 10 seconds. 


Examples of the TIME Parameter 


//STD1 JOB ACCT271,TIME=(12,10) 


This statement specifies that the maximum amount of time the job can use the processor 1s 12 
minutes, 10 seconds. 


//TYPE41 JOB ,GORDON, TIME=(,30) 


This statement specifies that the maximum amount of time the job can use the processor is 30 
seconds. 


//FORMS JOB’ ,MORRILL,TIME=5 


This statement specifies that the maximum amount of time the job can use the processor is 5 
minutes. 
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//RAINCK JOB 374231,MORRISON, TIME=1440 J 


This statement specifies an unlimited amount of time for job execution; the job can use the 
processor and remain in wait state for an unspecified period of time. The system will issue 
messages telling how much processor time the job used. 


Examples of the TIME Parameter on JOB and EXEC Statements 


//FIRST JOB , SMITH , TIME=2 
//STEP1 EXEC PGM=READER , TIME=1 


//STEP2 EXEC PGM=WRITER, TIME=1 


In this example, the job is allowed 2 minutes for execution and each step is allowed | minute. 
If either step continues executing beyond 1 minute, the entire job abnormally terminates 
beginning with that step. 


//SECOND JOB , JONES , TIME=3 
//STEP1 EXEC PGM=ADDER , TIME=2 
//STEP2 EXEC PGM=PRINT , TIME=2 J 


In this example, the job is allowed 3 minutes for execution, and each step is allowed 2 minutes. 
If either step continues executing beyond 2 minutes, the entire job abnormally terminates 
beginning with that step. If STEP1 executes for 1.74 minutes and STEP2 tries to execute 
beyond 1.26 minutes, the job abnormally terminates because of the 3-minute limit specified on 
the JOB statement. 
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C TYPRUN Parameter 
Parameter Type: Keyword, optional 


Purpose: Use the TYPRUN parameter to request special job processing. The TYPRUN 
parameter can tell the system to: 


@ Ina JES2 system, copy the input job stream directly to a sysout data set and schedule it for 
output processing. 


® Ina JES2 or JES3 system, place a job on hold until a special event occurs. When the event 
occurs, the operator, following your directions, must release the job from its hold to allow 
the system to select the job for processing. Use the JES2 /*MESSAGE statement or the 
JES3 //*OPERATOR statement to notify the operator to release the job. 


® Ina JES2 or JES3 system, scan a job’s JCL for syntax errors. 


c Syntax: 


TYPRUN= (COPY 
HOLD 


JCLHOLD 
SCAN 


SS Subparameter Definition 


COPY (JES2 only) 
Requests that JES2 copy the input job stream, as submitted, directly to a sysout data set 
and schedule the sysout data set for output processing. The system does not schedule the 
job for execution. The class of this sysout data set is the same as the message class of the 
job and is controlled by the JOB MSGCLASS parameter. 


Note: COPY is supported only in JES2 systems. 


(C HOLD 


Requests that the system hold the job before execution until the operator releases it. The 
operator should release the job when a particular event occurs. If an error occurs during 
input service processing, JES does not hold the job. 


JCLHOLD (JES2 only) 
Requests that JES2 hold the job before completing JCL processing. JES2 holds the job 
until the operator releases it. 


Note: JCLHOLD is supported only in JES2 systems. 
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ag een that the system scan this job’s JCL for syntax errors, without executing the job J 
or allocating devices. This parameter asks the system to check for: 
@ Invalid spelling of parameter keywords and some subparameter keywords. 
® Invalid characters. 
® Unbalanced parentheses. 
® Misplaced positional parameters on some statements. 


® Ina JES3 system only, parameter value errors or excessive parameters. 


® Invalid syntax on JCL statements in cataloged procedures invoked by any scanned 
EXEC statements. 


The system does not check for misplaced statements, for invalid syntax in JCL ) 
subparameters, or for parameters and/or subparameters that are inappropriate together. 


In a JES3 system, the system does not scan the JCL on the submitting system when a 
//*ROUTE or XMIT JCL statement follows the JOB statement. 


Relationship to Other Control Statements 


In a JES3 system, code PGM =JCLTEST or PGM=JSTTEST on the EXEC statement to scan 
a job step’s JCL. JCLTEST or JSTTEST provides for a step the same function as provided by J 
TYPRUN=SCAN for a job. 


Example of the TYPRUN Parameter 


//UPDATE JOB  ,HUBBARD 
//STEP1 EXEC PGM=LIBUTIL 


//LIST JOB  ,HUBBARD,TYPRUN=HOLD 
//STEPA EXEC PGM=LIBLIST 


Jobs UPDATE and LIST are submitted for execution in the same input stream. UPDATE 
executes a program that adds and deletes members of a library; LIST executes a program that 
lists the members of that library. For an up-to-date listing of the library, LIST must execute 
after UPDATE. To force this execution order, code TYPRUN=HOLD on JOB statement 
LIST. 


If a MONITOR JOBNAMES command is executed from the input stream or by the operator, 
the system notifies the console operator when UPDATE completes. The operator can then 
release LIST, allowing the system to select LIST for execution. 


15-42 MVS/XA JCL Reference 


C 


JOB: USER 


USER Parameter 


Parameter Type: Keyword, optional 


Purpose: Code the USER parameter to identify to the system the person submitting the job. 
The userid is used by the Resource Access Control Facility (RACF), the system resources 
manager (SRM), and other system components. 


If the installation contains the feature for propagation of the user and group identification, the 

USER, the PASSWORD, and, optionally, the GROUP parameters are required on JOB 

statements only for the following: 

@ Batch jobs submitted through an input stream, such as a card reader, (1) if the job requires 
access to RACF-protected resources or (2) if the installation requires that all jobs have 


RACF identification. 


@ Jobs submitted by one TSO user for another user. In this case, the JOB statement must 
specify the other user’s userid and password. The group id is optional. 


@ Jobs that execute at another network node that uses RACF protection. 
Otherwise, the USER, PASSWORD, and GROUP parameters can be omitted from JOB 
statements. RACF uses the userid, password, and default group id of the submitting TSO user 


or job. 


References: For more information on RACF-protected facilities, see Resource Access Control 
Facility (RACF) General Information Manual. 


Syntax: 


USER=userid 


Subparameter Definition 


Defaults 


userid 
Identifies a user to the system. The userid consists of 1 through 7 alphanumeric or 
national ($, #, @) characters; the first character must be alphabetic or national ($, #, @). 


If neither the JOB statement nor the submitting TSO user supplies identification information, 
RACY assigns a default userid and group id, unless the job enters the system via a JES internal 
reader. In that case, the user and default group identification of the submitting TSO user or 
job is used. 
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Relationship to Other Parameters 


If the JOB statement contains a GROUP or PASSWORD parameter, the statement must also 
contain a USER parameter. 


Example of the USER Parameter 


//TEST JOB 'D83,123456' ,USER=MYNAME , PASSWORD=ABCD 


This statement identifies the user submitting this job as MYNAME. 


15-44 MVS/XA JCL Reference 


Null Statement 


Chapter 16. Null Statement 


Use the null statement to mark the end of a job. 


Syntax: 


e The null statement consists of the characters // 1n columns 1 and 2. 
e@ The rest of the statement must be blank. 


Location in the JCL 


Place a null statement (1) at the end of a job’s control statements and data and (2) at the end of 
an input stream. 


The system can also recognize the end of a job when it reads the next JOB statement or when 
the input stream contains no more records. 


A null statement that does not end an input stream should be immediately followed by a JOB 
statement. The system ignores statements between a null statement and the next valid JOB 
statement. 


Note: JES2 ignores a NULL statement when it is included in a job’s JCL statements. JES2 
processes JES2 control statements following a NULL statement as part of the job (until the 
next JOB statement or EOF). 


If a null statement follows a control statement that is being continued, the system treats the null 


statement as a blank comment field and assumes that the control statement contains no other 
parameters. 
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Null Statement 


Example of the Null Statement 


//MYJOB JOB ,'C BROWN' 

//STEP1 EXEC PROC=FIELD 

//STEP2 EXEC PGM=XTRA 

//DD1 DD UNIT=3400-5 
* 


//DD2. + DD 
aes 

/t 

// 


The null statement indicates the end of job MYJOB. 
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Chapter 17. OUTPUT JCL Statement 


Purpose: Use the OUTPUT JCL statement to specify processing options for a system output 
(sysout) data set. These processing options are used only when the OUTPUT JCL statement is 
explicitly or implicitly referenced by a sysout DD statement. JES combines the options from 
this OUTPUT JCL statement with the options from the referencing DD statement. 


OUTPUT JCL statements are useful in processing the output of one sysout data set in several 
ways. For example, a sysout data set can be sent to a distant site for printing, as shown in 
statement OUT1, while it is also printed locally, as shown in statement OUT2: 


//OUT1L OUTPUT DEST=STLNODE.WMSMITH 
//OUT2 OUTPUT CONTROL=DOUBLE 
//DS DD SYSOUT=C ,, OUTPUT=(*.OUT1,*.OUT2) 


The parameters you can specify for sysout data set processing are arranged alphabetically in the 
following pages. 


Note: For JES3, some values you specify on the OUTPUT JCL statement may be lost when 
the sysout data set is requeued from the JES3 hold queue to the writer queue. For example, 
values on the FORMS or COPIES parameter may be lost, in which case the system uses the 
default values. 


References: For information about the JES initialization parameters that provide installation 
defaults, see SPL: JES2 Initialization and Tuning and SPL: JES3 Initialization and Tuning. 


Syntax: 


//name OUTPUT parameter[,parameter]... [comments] 


The OUTPUT JCL statement consists of the characters // in columns | and 2 and four 
fields: name, operation (OUTPUT), parameter, and comments. 


Name Field 


Code a name in the name field of every OUTPUT JCL statement, as follows: 


Each OUTPUT JCL name must be unique within a job. 

The name must begin in column 3. 

The name is | through 8 alphanumeric or national ($, #, @) characters. 
The first character must be alphabetic or national ($, #, @). 

The name must be followed by at least one blank. 
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Operation Field 


The operation field consists of the characters OUTPUT and must be preceded and followed by J 
at least one blank. It can begin in any column. 


Parameter Field 


The OUTPUT JCL statement contains only keyword parameters. All parameters are optional; 
however, do not leave the parameter field blank. You can code any of the keyword parameters 
In any order in the parameter field. 


KEYWORD PARAMETERS VALUES PURPOSE 


BURST= |YES YES or Y: burster-trimmer-stacker Directs output to a stacker 
4 NO or N: continuous forms stacker on a 3800 Printing Subsystem. 
NO 
N 


See page 17-9 . ) 


table-name 1 - 4 table-name subparameters: | - 4 Names character-arrangement 
CHARS = | (table-name[,table-name]...) alphanumeric or $, #, @ characters tables for printing on a 3800 

STD STD: character-arrangement table (JES3 only)| Printing Subsystem. Can request 

DUMP DUMP: 204-character print lines on 3800 a high-density dump on a 

(DUMP[,table-name]...) dump SYSABEND or SYSUDUMP 
DD statement. 


See page 17-11 


CKPTLINE=nnnnn nnnnn: 0 - 32767 Specifies the maximum lines in a 
logical page. (JES3 support is 


limited to 3800 Printing 
Subsystem Models 3, 6 and 8.) 


CKPTPAGE = nnnon nnnon: | - 32767 Specifies the number of logical 
pages to be printed or transmitted 
before JES takes a checkpoint. 
(JES3 support is limited to 3800 
Printing Subsystem Models 
3, 6 and 8.) 


See page 17-14 


See page 17-15 


CKPTSEC = nnnnn nnnon: | - 32767 Specifies how many seconds of 
printing are to elapse between 3 
each checkpoint of this sysout 
data set. (JES3 support is limited 
to 3800 Printing Subsystem 


Models 3, 6 and 8.) 
See page 17-16 


CLASS = {class class: A- Z,0-9 Assigns the sysout data set to an 
* *: same output class as MSGCLASS output class. 
parameter on JOB statement 


See page 17-17 
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COMPACT = compaction-table-name 


See page 17-20 


PROGRAM 
CONTROL= JSINGLE 

DOUBLE 

TRIPLE 


See page 17-21 


non 
COPIES = | (,(group-value[,group-value]...)) 


See page 17-22 


BLOCK 
DATACK = | UNBLOCK 
BLKCHAR 
BLKPOS 


See page 17-25 


DEFAULT = |YES 
Y 
NO 


N 


See page 17-27 


DEST = destination 


destination (JES2): 
LOCAL 
name 
Nnnon 
NnonRmmmm to NnnnnRmm 
nodename.userid 
Rnnnn or RMnnnn or RMTnonn 
Unnnn 


destination (JES3): 
ANYLOCAL 
device-name 
group-name 
nodename 
nodename.remote 


See page 17-30 


FCB = | fcb-name 
| STD 


See page 17-33 


VALUES 


compaction-table-name: | - 8 alphanumeric 
characters 


PROGRAM: each logical record begins with 
a carriage control character 

SINGLE: single spacing 

DOUBLE: double spacing 

TRIPLE: triple spacing 


nnn (JES2): 1 - 255 
non (JES3): 0 - 255 
1 - 8 group-values (JES2): 1 - 255 
1 - 8 group values (JES3): 1 - 254 


BLOCK: indicates errors are not reported 
UNBLOCK: indicates errors are reported 


BLKCHAR: indicates print errors are blocked 


BLKPOS: indicates data errors are blocked 


YES or Y: this statement can be implicitly 
referenced by sysout DD statements 

NO or N: this statement cannot be implicitly 
referenced by sysout DD statements. 


LOCAL: local device 

name: named local or remote device 

Nnonn: node (1 - 1000) 

NnRm: node (1 - 1000) and remote work 
station (1 - 9999); 6 digits maximum 
for n and m combined 

nodename.userid: node (1 - 8 
alphanumeric characters) and userid (1 - 8 
alphanumeric characters) 

Rnonn or RMnnnn or RMTnnnn: remote 
terminal (1 - 9999) 

Unnnon: local terminal (1 - 9999) 

ANYLOCAL: any local device 

device-name: local device (1 - 8 
alphanumeric or $, #, @ characters) 

group-name: | or more local devices or 
remote stations (1 - 8 alphanumeric or 
$, #, @ characters) 

nodename: node (1 - 8 alphanumeric or 
$, #, @ characters) 

remote: remote work station (1 - 8 
alphanumeric or $, #, @ characters) 


fcb-name: 1 - 4 alphanumeric or $, #, @ 
characters 
STD: standard FCB (JES3 only) 


OUTPUT JCL 


' PURPOSE 


Specifies a compaction table for 
sending this sysout data set to a 
SNA remote terminal. 


Specifies thatthe data set records 
begin with carriage control 
characters or specifies line 
spacing. 


Specifies number of copies printed. 
For a 3800 Printing Subsystem, 
can instead specify number of 
copies of each page printed before 
the next page is printed. 


Indicates whether or not print- 
positioning errors and invalid 

character data-check errors are 
to be blocked or not blocked. 


Specifies that this is a default 
OUTPUT JCL statement. 


Sends a sysout data set to the 
specified destination. 


Specifies FCB image, carriage 
control tape for 1403 Printer, or 
data-protection image for 3525 

Card Punch. 
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OUTPUT JCL 


KEYWORD PARAMETERS VALUES PURPOSE 


overlay-name 
FLASH = | (overlay-name[,count]) 

(,count) 

NONE 

STD 


See page 17-35 


FORMDEF = membername 


See page 17-38 


FORMS = (form-name 
STD | 


See page 17-40 


GROUPID = output-group 


See page 17-41 


INDEX =nn 


See page 17-43 


JESDS = | ALL 
JCL 
LOG 
MSG 


See page 17-44 


LINDEX=nn 


See page 17-47 
LINECT =nnn 
See page 17-48 


MODIFY = (| module-name 
({module-name][,trc]) 


See page 17-49 
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overlay-name: forms overlay frame (1 - 4 
alphanumeric or $, #, @ characters) 

count: copies with overlay (0 - 255) 

NONE: suppresses flashing 

STD: standard forms flash overlay 
(JES3 only) 


membername: | - 6 alphanumeric or 
$, #, @ characters 


form-name: 1 - 8 alphanumeric or $, #, @ 
characters 
STD: standard form (JES3 only) 


output-group: 1 - 8 alphanumeric characters 


ALL: all of job’s system-managed data sets 
JCL: all JCL processing data sets 

LOG: job’s hard-copy log 

MSG: job’s system messages 


nnn: 0 - 255 


module-name: 1 - 4 alphanumeric or $, #, @ 
characters 

trc: table-name in CHARS parameter 
(0 for first, 1 for second, 2 for third, 
and 3 for fourth table-name) 


For printing on a 3800 Printing 
Subsystem, indicates that the data 
set is to be printed with forms 
overlay and can specify how many 
copies are to be flashed. 


Names a library member 

that PSF uses in printing the 
sysout data set on a page-mode 
printer (such as a 3800 Model 3). 


Identifies forms on which the 
sysout data set is to be printed or 
punched. 


Specifies that this sysout data set 
belongs to a user-named output 
group. (JES2 only) 


Specifies how many print 
positions the left margin is to be 
indented for a sysout data set 
printed on a 321! Printer with the 
indexing feature. (JES2 only) 


Requests that the indicated system- 
managed data sets for the job be 
processed according to the 
parameters on this OUTPUT JCL 
statement. 


Specifies how many print 
positions the right margin is to be 
moved in from the full page width 
for a sysout data set printed on a 
3211 Printer with the indexing 
feature. (JES2 only) 


Specifies the maximum lines JES2 
is to print on each page. (JES2 
only) 


Specifies a copy-modification 
module in SYS1.[MAGELIB to 
be used by JES to print the data 
set on a 3800 Printing Subsystem. 


OUTPUT JCL 


KEYWORD PARAMETERS VALUES PURPOSE 


PAGEDEF = membername membername: | - 6 alphanumeric or $,#, @ | Names a library member 
characters that PSF uses in printing the 
sysout data set on a page-mode 


printer (such as a 3800 Model 3). 


See page 17-51 


YES: print messages from a functional 


PIMSG = | (YES[,msg-count]) Indicates that messages from a 


(NO[,msg-count]) subsystem functional subsystem should or 
NO: not print messages from a functional should not be printed in the listing 
subsystem following the sysout data set. 


msg-count: number of errors to cause printing 
to be terminated (0 - 999) 


See page 17-53 


PRMODE= |LINE LINE: send data set to line-mode printer Identifies the process mode 
PAGE PAGE: send data set to page-mode printer required to print the sysout data 
process-mode process-mode: installation-defined mode set. 


(1 - 8 alphanumeric characters) 
See page 17-55 


PRTY =nnn nnn: 0 - 255 (0 is lowest, 255 is highest) Specifies initial priority at which 
the sysout data set enters the 
output queue. 


See page 17-57 


THRESHLD = limit limit: 1 - 99999999 Specifies the maximum size for a 
sysout data set. Use it to obtain 
simultaneous printing of large 
data sets or many data sets from 
one job. (JES3 only) 

See page 17-58 


TRC= | YES YES or Y: data set contains TRC codes Specifies whether or not the 

Y NO or N: data set does not contain TRC sysout data set’s records contain 
NO codes table reference codes (TRC) as 
N the second character. 


See page 17-60 


UCS = character-set-code character-set-code: 1 - 4 alphanumeric or Specifies universal character set, 
$, #, @ characters print train, or character- 


arrangement table for a 3800 
Printing Subsystem. 
See page 17-62 


WRITER = name name: | - 8 alphanumeric characters Names an external writer to 
process the sysout data set rather 
than JES. 


See page 17-65 


Default OUTPUT JCL Statement: An OUTPUT JCL statement that contains a 
DEFAULT= YES parameter is called a default OUTPUT JCL statement. 


Comments Field 


The comments field follows the parameter field after at least one intervening blank. 
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OUTPUT JCL 


Location in the JCL 


You must place an OUTPUT JCL statement in the input stream before any sysout DD 
statement that refers to it. 


References by Sysout DD Statements: An OUTPUT JCL statement can be referenced by a 
sysout DD statement in two ways: 


e Explicitly. The sysout DD statement contains an OUTPUT parameter that specifies the 
name of the OUTPUT JCL statement. 


e Implicitly. The sysout DD statement does not contain an OUTPUT parameter. Implicit 
references are to default OUTPUT JCL statements and require that the job or step contain 
one or more default OUTPUT JCL statements preceding the sysout DD statement. 


Note: If the sysout DD statement does not contain an OUTPUT parameter and thé job or 
step does not contain a default OUTPUT JCL statement, processing of the sysout data sét is 
controlled only by the DD statement, a JES2 /*“OUTPUT statement or JES3 //*FORMAT 
statement, and appropriate installation defaults. 


Job-Level OUTPUT JCL Statements: This statement appears after the JOB statement and 
before the first EXEC statement. 


Step-Level OUTPUT JCL Statements: This statement appears in a step, that is, anywhere after 
the first EXEC statement in a job. 


Location of Default OUTPUT JCL Statements: Where you place default OUTPUT JCL 
statements determines which statements a sysout DD statement refers to in an itnplicit 
reference, as follows: 


e Asysout DD statement implicitly references all step-level default OUTPUT JCE statements 
in the same step. 


e A sysout DD statement implicitly references all job-level default OUTPUT JCL statements 
when the step containing the DD statement does not contain any step-level default 
OUTPUT JCL statements. 


You can place more than one job- or step-level default OUTPUT JCL statement in a job or 
step. 


OUTPUT JCL Statement with JESDS Parameter: Place an OUTPUT JCL statement with a 
JESDS parameter after the JOB statement and before the first EXEC statement. 


OUTPUT JCL Statements in Cataloged or In-Stream Procedures: OUTPUT JCL statements 
can appear in procedure steps. The referencing DD statement can appear later in the 
procedure, in the calling job step, or in a later step in the job. 


An OUTPUT JCL statement must not be placed before the first EXEC statement in a 
procedure; for this reason, procedures cannot contain job-level OUTPUT JCL statements or 
OUTPUT JCL statements with JESDS parameters. 


A procedure DD statement can refer to an OUTPUT JCL statement in an earlier job step or to 


a job-level OUTPUT JCL statement. However, a procedure DD statement cannot refer to an 
OUTPUT JCL statement in the calling step. 
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OUTPUT JCL 


Job in Input Stream //jobname JOB sre 
//name OUTPUT ... Job-level OUTPUT JCL statement 
Step 1 //STEP1 EXEC PGM=X 
//name OUTPUT ..«% Step-level OUTPUT JCL statement for STEP1 
//DD1 
//DD2 
//DD3 DD abt 
//STEP2 EXEC PROC=A 
//name OUTPUL aie Step-level OUTPUT JCL statement for STEP2 
//DD1 
//DD2 
//DD3 


Procedure _A_in 
SYS1.PROCLIB // PROC eara 
Procedure Step 1 //PSTEP1 EXEC PGM=G 
//name OUTPUT ... Step-level OUTPUT JCL statement for PSTEP!1 
//DD4 
//DDS 
//DD6 DD eee 
Procedure Step 2 //PSTEP2 EXEC PGM=H 
//name OUTPUT ... Step-level OUTPUT JCL statement for PSTEP2 
//DD7 
//DD8 
//DD9Y 


Figure 17-1. Job- and Step-Level OUTPUT JCL Statements in the JCL 


Overrides 


e Parameters on a sysout DD statement override corresponding parameters on an OUTPUT 
JCL statement. 


e Parameters that appear only on the sysout DD statement or only on the OUTPUT JCL 
statement are used by JES in processing the data set. 


Relationship to Sysout DD Statement 
Do not refer to an OUTPUT JCL statement in a sysout DD statement that defines a JES 


internal reader. Such a DD statement contains an INTRDR subparameter in the SYSOUT 
parameter. 
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OUTPUT JCL 


Relationship to the JES2 /*OUTPUT Statement 


JES2 ignores a JES2 /*OUTPUT statement when either of the following appears in the same 
job or step: 


e A default OUTPUT JCL statement implicitly referenced by the sysout DD statement. 


e An OUTPUT JCL statement explicitly referenced by the OUTPUT parameter of the sysout 
DD statement. 


In this case, JES2 uses the third positional subparameter of the DD SYSOUT parameter as a 
form name, and not as a reference to a JES2 /*OUTPUT statement. 


Relationship to the JES3 //*FORMAT Statement 


@ When a sysout DD statement implicitly or explicitly references an OUTPUT JCL 
statement, JES3 ignores any default JES3 //*FORMAT statements in the job. A default ) 
//*FORMAT statement contains a DDNAME=, parameter. 


e@ When a JES3 //*FORMAT statement contains a DDNAME parameter that explicitly 
references a sysout DD statement, JES3 ignores any default OUTPUT JCL statements in 
the job. 


e JES3 uses the processing options from both a JES3 //*FORMAT statement and an 
OUTPUT JCL statement in a job when (1) the //*FORMAT statement DDNAME 
parameter names a sysout DD statement and (2) the sysout DD statement’s OUTPUT 
parameter names an OUTPUT JCL statement. Two separate sets of output are created 
from the data set defined by the sysout DD statement: 


— One processed according to the options on the JES3 //‘FORMAT statement combined 
with the sysout DD statement. 


— One processed according to the options on the OUTPUT JCL statement combined with 
the sysout DD statement. 


For more information on the use of the OUTPUT JCL statement with JES3, see MVS/XA ) 
SPL: JES3 Initialization and Tuning. | 
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OUTPUT JCL: BURST 


BURST Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the BURST parameter to specify that the output for the sysout data set printed 
on a 3800 Printing Subsystem is to go to: 


e The burster-trimmer-stacker, to be burst into separate sheets. 
e The continuous forms stacker, to be left in continuous fanfold. 


If the specified stacker is different from the last stacker used, or if a stacker was not previously 
requested, JES issues a message to the operator to thread the paper into the required stacker. 


Note: BURST applies only for a data set printed on a 3800 equipped with a 
burster-trimmer-stacker. 


Syntax: 
BURST= (YES 
Y 
NO 
N 


Subparameter Definition 


Defaults 


Overrides 


YES 
Requests that the printed output is to be burst into separate sheets. This subparameter 
can also be coded as Y. 


NO 


Requests that the printed output is to be in a continuous fanfold. This subparameter can 
also be coded as N. 


If you do not code a BURST parameter and the sysout data set is printed on a 3800 that has a 
burster-trimmer-stacker, JES uses an installation default specified at initialization. 


A BURST parameter on the sysout DD statement overrides the OUTPUT JCL BURST 
parameter. 


Chapter 17. OUTPUT JCL Statement 17-9 


OUTPUT JCL: BURST 


Example of the BURST Parameter 


//OUTDS1 OUTPUT BURST=YES 


In this example, the output from the 3800 will be burst into separate sheets. 
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OUTPUT JCL: CHARS 


CHARS Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the CHARS parameter to specify the name of one or more 
character-arrangement tables for printing the sysout data set on a 3800 Printing Subsystem. 


Note: 


e CHARS applies only for a data set printed on a 3800. 
e STD applies only on a JES3 system. 


References: Yor more information on character-arrangement tables, see the 3800 Printing 
Subsystem Programmer's Guide. Refer to Installation: System Generation for information on 
how to choose during system generation particular groups, other than the Basic group, which is 
always available. 


Syntax: 


table-name 
CHARS= | (table-name[,table-name]...) 
STD 
DUMP 
(DUMP[,table-name]...) 


e You can omit the parentheses if you code only one table-name. 


e Null positions in the CHARS parameter are invalid. For example, you cannot code 
CHARS =(,table-name) or CHARS = (table-name,,table-name). 


Subparameter Definition 


table-name 
Names a character-arrangement table. Each table-name is 1 through 4 alphanumeric or 
national ($, #, @) characters. Code one to four names. 


STD 
Specifies the standard character-arrangement table. JES3 uses the standard table specified 


at initialization. 


Note: STD is supported only on JES3 systems. 
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DUMP 
Requests a high-density dump of 204-character print lines from a 3800. If more than one 
table-name is coded, DUMP must be first. 


Note: DUMP is valid only on the OUTPUT JCL statement referenced in a SYSABEND 
or SYSUDUMP DD statement that specifies a sysout data set for the dump. 


Defaults 
If you do not code the OUTPUT JCL CHARS parameter, JES uses the following, in order: 
1. The DD CHARS parameter. 
2. The DD UCS parameter value, if coded. 
3. The OUTPUT JCL UCS parameter value, if coded. 


If no character-arrangement table is specified on the DD or OUTPUT JCL statements, JES 
uses an installation default specified at initialization. 


Overrides 


A CHARS parameter on the sysout DD statement overrides the OUTPUT JCL CHARS 
parameter. 


For a data set scheduled to the Print Services Facility (PSF), the PSF uses the following 
parameters, in override order, to select the font list. 


Font list in the library member specified by an OUTPUT JCL PAGEDEF parameter. 
DD CHARS parameter. 

OUTPUT JCL CHARS parameter. 

DD UCS parameter. 

OUTPUT JCL UCS parameter. 

JES installation default for the device. 

Font list on the PAGEDEF parameter in the PSF cataloged procedure. 


a ee 


See “PAGEDEF Parameter” on page 17-51 for more information. 


Requesting a High-Density Dump 


You can request a high-density dump on the 3800 through two parameters on the DD 
statement for the dump data set or on an OUTPUT JCL statement referenced by the dump DD 
statement: 


e FCB=STD3. This parameter produces dump output at 8 lines per inch. 
e CHARS=DUMP. This parameter produces 204-character print lines. 


You can code one or both of these parameters. You can place both on the same statement or 
one on each statement. 
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OUTPUT JCL: CHARS 


Example of the CHARS Parameter 


//OUTDS2 OUTPUT CHARS=(GT12,GB12,GI12) 


In this example, the output from the 3800 will be printed in three upper and lower case fonts: 
GT12, Gothic 12-pitch; GB12, Gothic Bold 12-pitch; and GI12, Gothic Italic 12-pitch. 
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OUTPUT JCL: CKPTLINE 


CKPTLINE Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the CKPTLINE parameter to specify the maximum number of lines in a logical 
page. JES uses this value, with the CKPTPAGE parameter, to determine when to take 
checkpoints while printing the sysout data set or transmitting the systems network architecture 
(SNA) data set. 


Note: Ina JES3 system, this parameter is supported when the Print Services Facility (PSF) 
prints the sysout data set on a 3800 Printing Subsystem Models 3, 6 and 8. 


Syntax: 


CKPTLINE=nnnnn 


Subparameter Definition 


nonnn 
Specifies the maximum number of lines in a logical page. nnnnn is a number from 0 
through 32767. 


Defaults 


If you do not code the CKPTLINE parameter, JES2 uses an installation default specified at 
initialization. JES3 provides no installation default. 


Example of the CKPTLINE Parameter 


//OUTDS3 OUTPUT CKPTLINE=4000,CKPTPAGE=5 


In this example, the sysout data set will be checkpointed after every 5 logical pages. Each 
logical page contains 4000 lines. 
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OUTPUT JCL: CKPTPAGE 


CKPTPAGE Parameter 


Parameter Type: Keyword, optional 
Purpose: Use the CKPTPAGE parameter to specify the number of logical pages: 
e@ To be printed before JES takes a checkpoint. 


e To be transmitted as a single systems network architecture (SNA) chain to an SNA work 
station before JES takes a checkpoint. 


The number of lines in these logical pages is specified in the CKPTLINE parameter. 


Note: In a JES3 system, this parameter is supported when the Print Services Facility (PSF) 
prints the sysout data on a 3800 Printing Subsystem Models 3, 6 and 8. 


Syntax: 


CKPTPAGE=nnnnn 


Subparameter Definition 
nennp 


Specifies the number of logical pages to be printed or transmitted before the next sysout 
data set checkpoint is taken. nnnnn is a number from | through 32767. 


Defaults 
If yan do not code the CKPTPAGE parameter, JES2 uses an installation default specified at 


initialization; the default may also indicate whether checkpoints are to be based on page count 
or time. JES3 provides no installation default. 


Relationship to Other Parameters 
If you code both the CKPTPAGE and CKPTSEC parameters: 
@ JES2 uses the value on the CKPTSEC parameter, provided the installation did not specify 


at initialization that checkpoints are to be based only on page count or time. 
@ JES3 uses the value on the CKPTPAGE parameter. 


Example of the CKPTPAGE Parameter 


f/OUTDS4 OUTPUT CKPTPAGE=128,CKPTLINE=58 


In this example, the sysout data set will be checkpointed after every 128 logical pages. Each 
logical page contains 58 lines. 
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OUTPUT JCL: CKPTSEC 


CKPTSEC Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the CKPTSEC parameter to specify how many seconds are to elapse between 
checkpoints of the sysout data set that JES is printing. 


Note: Ina JES3 system, this parameter is supported when the Print Services Facility (PSF) 
prints the sysout data set on a 3800 Printing Subsystem Models 3, 6 and 8. 


Syntax: 


CKPTSEC=nnnnn 


Subparameter Definition 
hnnnn 


Specifies the number of seconds that is to elapse between checkpoints. nnnnn is a number 
from | through 32767. 


Defaults 
If you do not code the CKPTSEC parameter, JES2 uses an installation default specified at 


initialization; the default may also indicate whether checkpoints are to be based on page count 
or time. JES3 provides no installation default. 


Relationship to Other Parameters 
If you code both the CKPTPAGE and CKPTSEC parameters: 


e JES2 uses the value on the CKPTSEC parameter, provided the installation did not specify 
at initialization that checkpoints are to be based only on page count or time. 


e JES3 uses the value on the CKPTPAGE parameter. 


Example of the CKPTSEC Parameter 


//OUTDSS OUTPUT CKPTSEC=120 


In this example, the sysout data set will be checkpointed after every 120 seconds, or 2 minutes. 
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OUTPUT JCL: CLASS 


CLASS Parameter 


Parameter Type: Keyword, optional 
Purpose: Use the CLASS parameter to assign the sysout data set to an output class. 


Note: Ifa sysout data set has the same class as the JOB statement MSGCLASS parameter, the 
job log appears on the same output listing as the sysout data set. 


Syntax: 


CLASS= |class 


* 


Subparameter Definition 
class 
Identifies the output class for the data set. The class is one character: A through Z or 0 


through 9. The attributes of each output class are defined during JES initialization; 
specify the class with the desired attributes. 


Requests the output class in the MSGCLASS parameter on the JOB statement. 


Overrides 
The class subparameter of the DD statement SYSOUT parameter overrides the OUTPUT JCL 


CLASS parameter. On the DD statement, you must code a null class in order to use the 
OUTPUT JCL CLASS parameter; for example: 


//OUTDS DD SYSOUT=(,) ,OUTPUT=*.OUT1 


Held Classes in a JES2 System 


An installation option at JES2 initialization determines if both the class for the sysout data set 
and the class for the job’s messages must be held in order for a sysout data set to be held. 


A sysout data set is held in the following cases: 
e The sysout DD statement contains HOLD= YES. 


e The sysout DD statement does not contain a HOLD parameter or contains HOLD=NO 
but requests a class that the installation defined as held and defined as: 


— Not requiring the message class to be a held class in order for the sysout data set to be 
held. The JOB statement MSGCLASS parameter can specify any class. 


— Requiring the message class to be a held class in order for the sysout data set to be 
held. The JOB MSGCLASS parameter must also specify a held class. 
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A sysout data set is not held in the following cases: 


@ The sysout DD statement does not contain a HOLD parameter or contains HOLD=NO 
and requests: 


— Aclass that the installation defined as not held. 
— Acclass that the installation defined as held and defined as requiring the message class 
to be a held class in order for the sysout data set to be held. The JOB MSGCLASS 


parameter must specify a class that is not held. 


Contact the installation to find out if holding the sysout class depends on a held MSGCLASS 
class. 


Held Classes in a JES3 System 


If CLASS specifies a class-name that is defined to JES3 as a held class for the output service 
hold queue (Q=HOLD), all of the new output characteristics might not be included in the data 
set on the writer queue when (1) the data set is moved from the hold queue to the output 
service writer queue (Q= WTR), (2) the data set includes an OUTPUT JCL statement, and (3) 
the NQ= or NCL= keyword is used. 


For more information, see MVS/XA SPL: JES3 Initialization and Tuning. 


Significance of Output Classes 


To print this sysout data set and the messages from your job on the same output listing, code 
one of the following: 


e The same output class in the DD SYSOUT parameter as in the JOB MSGCLASS 
parameter. 


e DD SYSOUT=* to default to the JOB MSGCLASS output class. 
e DD SYSOUT=<() to default to one of the following: 
1. The CLASS parameter in an explicitly or implicitly referenced OUTPUT JCL 
statement. In this case, the OUTPUT JCL CLASS parameter should specify the same 
output class as the JOB MSGCLASS parameter. 


2. The JOB MSGCLASS output class, if no OUTPUT JCL statement is referenced or if 
the referenced OUTPUT JCL statement contains CLASS=*. 


17-18 MVS/XA JCL Reference 


OUTPUT JCL: CLASS 


Examples of the CLASS Parameter 


//OUTDS6 OUTPUT CLASS=D 
//OUT1 DD SYSOUT=(,) ,OUTPUT=* .OUTDS6 


In this example, JES processes the sysout data set defined in DD statement OUT! in output 


class D. 

//PRINTALL JOB ACCT123 ,MAEBIRD,MSGCLASS=H 
//STEP1 EXEC  PGM=PRINTER 

//OUTDS7 OUTPUT CLASS=* 

//OUTPTR DD SYSOUT=(,) ,OUTPUT=*.OUTDS7 


In this example, JES processes the sysout data set defined in DD statement OUTPTR in output 
class H, as specified in the JOB statement MSGCLASS parameter. The same result could be 
obtained by the following: 


//PRINTALL JOB ACCT123 ,MAEBIRD,MSGCLASS=H 
//STEP1 EXEC PGM=PRINTER 
//OUTPTR DD SYSOUT=H 
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OUTPUT JCL: COMPACT 


COMPACT Parameter 


Parameter Type: Keyword, optional 
Purpose: Use the COMPACT parameter to specify a compaction table for JES to use when 
sending the sysout data set, which is a systems network architecture (SNA) data set, toa SNA 


remote terminal. 


Syntax: 


COMPACT=compaction-table-name 


Subparameter Definition 
compaction-table-name 
Specifies a compaction table by a symbolic name. The name is | through 8 alphanumeric 


characters. The symbolic name must be defined by the installation during JES 
initialization. 


Defaults 


If you do not code the COMPACT parameter, compaction is suppressed for the data set. 


Overrides 


This parameter overrides any compaction table value defined at the SNA remote terminal. 


Example of the COMPACT Parameter 


//OUTDS8 OUTPUT DEST=N555R222,COMPACT=TBL77 


In this example, the sysout data set will be sent to remote terminal 222 at node 555; JES will 
use compaction table TBL77. 
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OUTPUT JCL: CONTROL 


CONTROL Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the CONTROL parameter to specify either that each logical record starts with a 
Carriage control character or that the output is to be printed with single, double, or triple 


spacing. 
Syntax: 
PROGRAM 
CONTROL=| SINGLE 
DOUBLE 
TRIPLE 


Subparameter Definition 
PROGRAM 
Indicates that each logical record in the data set begins with a carriage control character. 


The carriage control characters are given in Data Administration Guide. 


SINGLE 
Indicates forced single spacing. 


DOUBLE 
Indicates forced double spacing. 


TRIPLE 
Indicates forced triple spacing. 


Defaults 


If you do not code the CONTROL parameter, JES3 uses an installation default specified at 
initialization. 


In a JES2 system, an installation default can be provided for each local device by an operator 
command. 


Example of the CONTROL Parameter 


//OUTDSY OUTPUT CONTROL=PROGRAM 


In this example, the sysout data set is printed using the first character of each logical record for 
carriage control. 
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OUTPUT JCL: COPIES 


COPIES Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the COPIES parameter to specify how many copies of the sysout data set are to 
be printed. The printed output is in page sequence for each copy. 


For printing on a 3800 Printing Subsystem, this parameter can instead specify how many copies 
of each page are to be printed before the next page is printed. 


Syntax: 


COPIES= jJnnn 
(, (group-value[,group-value]...)) 


e You can omit the parentheses if you code only COPIES =nnn. 


@ The following are not valid: 


— A null group-value, for example, COPIES =(5,(,)) or COPIES =(5,) 
— A zero group-value, for example, COPIES =(5,(1,0,4)) 
— A null within a list of group-values, for example, COPIES = (5,(1,,4)) 


Subparameter Definition J 


non 
Specifies how many copies of the sysout data set are to be printed; each copy will be in 
page sequence order. nnn is | through 3 decimal numbers from 1 through 255 in a JES2 
system and from 0 through 255 in a JES3 system. 


For a data set printed on a 3800, JES ignores nnn if any group values are specified. 


group-value J 
Specifies how many copies of each page are to be printed before the next page is printed. 
Each group-value is 1 through 3 decimal numbers from | through 255 in a JES2 system 
and from 1 through 254 in a JES3 system. You can code a maximum of eight 
group-values. Their sum must not exceed 255 or 254. The total copies of each page 
equals the sum of the group-values. 


Note: 


e This subparameter is valid only for 3800 output. 
@ For 3800 output, this subparameter overrides an nnn subparameter, if coded. 
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Defaults 


For JES2, on the DD, OUTPUT JCL, or /*OUTPUT statement: if you do not code a 
COPIES parameter, code it incorrectly, or code COPIES =0, the system uses a default of 1, 
which is the default for the DD COPIES parameter. 


For JES3, on the DD, OUTPUT JCL, or //*FORMAT statement: if you do not code a 
COPIES parameter, code it incorrectly, or code COPIES =0 on the DD statement, the system 
uses a default of 1, which is the default for the DD COPIES parameter. 


Overrides 


A COPIES parameter on the sysout DD statement overrides the OUTPUT JCL COPIES 
parameter. 


If the OUTPUT JCL statement contains a FORMDEF parameter, which specifies a library 
member, the COPYGROUP parameter on a FORMDEF statement in that member overrides 
any group-value subparameters on the OUTPUT JCL COPIES parameter or the sysout DD 
COPIES parameter. For more information, see “FORMDEF Parameter” on page 17-38. 


Relationship to Other Parameters 


If the OUTPUT JCL or the sysout DD statement contains a FLASH parameter, JES prints 
with the forms overlay the number of copies specified in one of the following: 


e COPIES=nnn, if the FLASH count is larger than nnn. For example, if COPIES=10 and 
FLASH =(LTHD,12) JES prints 10 copies, all with the forms overlay. 


e The sum of the group-values specified in the COPIES parameter, if the FLASH count is 
larger than the sum. For example, if COPIES = (,(2,3,4) and FLASH =(LTHD,12) JES 
prints nine copies in groups, all with the forms overlay. 


@ The count subparameter in the FLASH parameter, if the FLASH count is smaller than nnn 
or the sum from the COPIES parameter. For example, if COPIES=10 and 
FLASH =(LTHD,7) JES prints seven copies with the forms overlay and three copies 
without. 


Relationship to Other Control Statements 
For JES2, if you request copies of the entire job on the JES2 /*JOBPARM COPIES parameter 


and also copies of the data set on the DD COPIES or OUTPUT JCL COPIES parameter, JES2 
prints the number of copies equal to the product of the two requests. 
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Examples of the COPIES Parameter 


//RPTDS OUTPUT COPIES=4,FORMS=WKREPORT 
This example asks JES to print four copies of the weekly report on forms named WK REPORT. 
//EXPLD OUTPUT COPIES=(,(3)),FORMS=ACCT 


This example asks JES to print the first page three times, then the second page three times, the 
third page three times, etc., on forms named ACCT. 


//QUEST OUTPUT COPIES=(,(8,25,18,80) ) ,FORMS=ANS 


This example asks JES to print each page eight times before printing the next page, then 25 
times before the next, then 18 times before the next, and finally 80 times before the next. The 
forms are named ANS. 


//EXMP OUTPUT COPIES=(5,(3,2)) 
This example asks JES to do one of the following: 
e If the data set is printed on other than a 3800, to print five copies. 


e If itis printed on a 3800, to print each page three times before printing the next page and 
then to print each page twice before printing the next page. 
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DATACK Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the DATACK parameter to indicate whether or not print-positioning and 
invalid-character data-check errors are to be blocked or unblocked for printers accessed through 
the functional subsystem Print Services Facility (PSF). 


A print-positioning error occurs when the designated position of any kind of printable 
information is beyond the limits of either the physical page, or the overlay or logical page of 
which it is part. 


An invalid-character data-check error occurs when the hexadecimal representation of a text 
character has no mapping in the code page to a member of the font raster patterns. 


If an error type is unblocked, the printer reports the error at the end of the page in which it 
occurs, and PSF processes the error and generates an error message. (See the PIMSG 
parameter for more information on the printing of error messages.) 


If an error type is blocked, the printer does not report the error to PSF. Printing continues but 
data may be lost on the output. 


References: For more information on data-check errors and their processing through PSF, see 
Print Services Facility User's Programming Guide for MVS or Print Services Facility System 
Programmer's Guide for MVS. 


Syntax: 


DATACK= | BLOCK 
UNBLOCK 


BLKCHAR 
BLKPOS 


Subparameter Definition 


BLOCK 
Indicates that print-positioning errors and invalid-character errors are not reported to 
PSF. 


UNBLOCK 
Indicates that print-positioning errors and invalid-character errors are reported to PSF. 


BLKCHAR 
Indicates that invalid-character errors are blocked, and not reported to PSF. 
Print-positioning errors are reported normally. 


BLKPOS 


Indicates that print-positioning errors are blocked, and not reported to PSF. 
Invalid-character errors are reported normally. 
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Defaults 


If you do not code the DATACK parameter, the DATACK specification from the PSF 
PRINTDEV statement is used. If not specified in the PRINTDEV statement, the default is 
BLOCK. 


Relationship to Other Parameters 


If DATACK is specified as UNBLOCK, BLKCHAR, or BLKPOS, and an unblocked error 
occurs, the printer reports the error to PSF which processes the error. The coding of the 
PIMSG parameter then determines whether or not printing of the data set continues after the 
page in error, and if error messages are printed at the end of the data set. 


Example of the DATACK Parameter 


//OUTDS1 OUTPUT DATACK=BLKCHAR, PIMSG=(YES,0) J 


In this example, when a print-position error occurs, it is reported to the user via a printed error 
message. If an invalid-character error occurs, it is not reported. In either case, the printing of 
the data set continues, and all functional subsystem messages are printed. 
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DEFAULT Parameter 


Parameter Type: Keyword, optional 

Purpose: Use the DEFAULT parameter to specify that this OUTPUT JCL statement can or 
cannot be implicitly referenced by a sysout DD statement. An OUTPUT JCL statement that 
contains a DEFAULT= YES parameter is called a default OUTPUT JCL statement. 


Syntax: 


DEFAULT= (YES 
Y 


NO 
N 


Subparameter Definition 


YES 
Indicates that this OUTPUT JCL statement can be implicitly referenced by sysout DD 
statements. This subparameter can also be coded as Y. 


NO 


Indicates that this OUTPUT JCL statement cannot be implicitly referenced by sysout DD 
statements. This subparameter can also be coded as N. 


Defaults 
If you do not code DEFAULT = YES, the default is NO. In order to take effect, an OUTPUT 


JCL statement without DEFAULT = YES must be explicitly referenced in an OUTPUT 
parameter on a sysout DD statement. 


Location in the JCL 


e A Sstep-level OUTPUT JCL statement appears within a step, that is, anywhere after the first 
EXEC statement in a job. 


e A job-level OUTPUT JCL statement appears after the JOB statement and before the first 
EXEC statement. 


@ You can place more than one job- or step-level default OUTPUT JCL statement in a job or 
step. 


e You must place an OUTPUT JCL statement in the input stream before any sysout DD 
statement that explicitly or implicitly refers to it. 
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References to Default OUTPUT JCL Statements 


e Asysout DD statement makes an explicit reference in an OUTPUT parameter that specifies 
the name of an OUTPUT JCL statement. 


e A-sysout DD statement makes an implicit reference when it does not contain an OUTPUT 
parameter, and the job or step contains one or more default OUTPUT JCL statements. 


e A -sysout DD statement implicitly references all step-level default OUTPUT JCL statements 
in the same step. 


e A sysout DD statement implicitly references all job-level default OUTPUT JCL statements 
when the step containing the DD statement does not contain any step-level default 
OUTPUT JCL statements. 


e A sysout DD statement can explicitly reference a default OUTPUT JCL statement. 


Example of the DEFAULT Parameter 


/ /EXMP 2 JOB ACCT555 ,MAEBIRD ,MSGCLASS=B 
//OUTDAL OUTPUT DEFAULT=YES,DEST=DALLAS 
//OUTPOK OUTPUT DEST=POK 


//STEP1 EXEC PGM=REPORT 

//OUTHERE OUTPUT CLASS=D 

//SYSIN DD * 

f= 

/ /WKRPT DD UNIT=VIO,DISP=(,PASS) 

//RPTL DD SYSOUT=(,) ,OUTPUT=* .OUTHERE 

/ /RPT2 DD SYSOUT=A 

/ /STEP2 EXEC PGM=SUMMARY 

/ /OUTHQ OUTPUT DEFAULT=YES , DEST=HQ 

//WKDATA DD UNIT=VIO,DISP=(OLD,DELETE) , DSNAME=* .STEP1.WKRPT 
/ /MONTH DD SYSOUT=(,) ,OUTPUT=* .STEP1.OUTHERE 
//SUM DD SYSOUT=A 

//FULRPT DD SYSOUT=A , OUTPUT=(* .OUTDAL, *.OUTPOK) 


In this example, the JOB named EXMP2 contains two job-level OUTPUT JCL statements: 
OUTDAL and OUTPOK. OUTDAL is a default OUTPUT JCL statement because it contains 
DEFAULT= YES; OUTDAL can be implicitly referenced by a sysout DD statement. 
OUTPOK must be explicitly referenced in a sysout DD OUTPUT parameter for its processing 
options to be used. The purpose of both of these OUTPUT JCL statements is to specify a 
destination for a sysout data set. 


STEP! contains a step-level OUTPUT JCL statement: OUTHERE. The purpose of this 
statement is to specify that JES process the data set locally in output class D. OUTHERE can 
be used only if it is explicitly referenced. 


STEP2 contains a step-level default OUTPUT JCL statement: OUTHQ. The purpose of this 
statement is to specify a destination for a sysout data set. OUTHQ can be implicitly 
referenced. 
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The references in this job are as follows: 


@e In STEP! and STEP2, sysout DD statements RPT1 and MONTH explicitly reference 
OUTPUT JCL statement OUTHERE. These two sysout data sets are printed locally in the 
same output class. 


Note: You can explicitly reference an OUTPUT JCL statement in a preceding job step. 


e In STEP1, DD statement RPT2 implicitly references OUTPUT JCL statement OUTDAL. 
This implicit reference occurs because all of the following are true: 


1. DD statement RPT2 contains a SYSOUT parameter but does not contain an OUTPUT 
parameter. Thus, this DD statement is making an implicit reference. 


2. STEP1 does not contain a default OUTPUT JCL statement, so the implicit reference 
must be to job-level default OUTPUT JCL statements. 


3. OUTDAL 1s the only job-level default OUTPUT JCL statement. 


e In STEP2, DD statement SUM implicitly references OUTPUT JCL OUTHQ because all of 
the following are true: 


1. DD statement SUM contains a SYSOUT parameter but does not contain an OUTPUT 
parameter. Thus, this DD statement is making an implicit reference. 


2. STEP2 contains a default OUTPUT JCL statement: OUTHQ. Therefore, the implicit 
reference is to OUTHQ and cannot be to any job-level default OUTPUT JCL 
statements. 


e In STEP2, DD statement FULRPT explicitly references OUTPUT JCL statements 
OUTDAL and OUTPOK. 
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DEST Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the DEST parameter to specify a destination for the sysout data set. The DEST 
parameter can send a sysout data set to a remote or local terminal, a node, a node and remote 
work station, a local device or group of devices, or a node and userid. 


Syntax: 


DEST=destination 
The destination subparameter for JES2 is one of the following: 


LOCAL 
name 
Nnnnn 
NnnRmmmm 
NnnnRmmm 
NnonnnRmm 
nodename.userid 
Rnnnn 
RMnnnn 
RMTnnnn 
Unnnn 


The destination subparameter for JES3 is one of the following: 


ANYLOCAL 
device-name 
group~-name 
nodename 
nodename.userid 


Subparameter Definition for JES2 Systems 


17-30 


LOCAL 
Indicates any local device. 


name 
Identifies a local or remote device by a symbolic name defined by the installation during 


JES2 initialization. The name is | through 8 alphanumeric or national ($, #, @) 
characters. 


Nnoann 


Identifies a node. nnnn is 1 through 4 decimal numbers from 1 through 1000. For 
example, N103. 


NanRmmmm 

NaonnRmmm 

NnannnanRmm 
Identifies a node and a remote work station connected to the node. The node number, 
indicated in the format by n, is 1 through 4 decimal numbers from 1 through 1000. The 
remote work station number, indicated in the format by m, is 1 through 4 decimal 
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numbers from | through 9999. Do not code leading zeros in n or m. The maximum 
number of digits for n and m combined cannot exceed six. 


Note: RO is equivalent to LOCAL specified at node Nn. 


nodename.userid 
Identifies a destination node and a VM or a TSO userid, a remote workstation, or a 
symbolic name defined at the destination node. The nodename is a symbolic name 
defined at the node of execution. nodename is 1 through 8 alphanumeric or national ($, 
#, @) characters. userid is 1 through 8 alphanumeric or national ($, #, @) characters, 
and must be defined at the specified node. 


Note: Ifa data set is queued for transmission and an operator changes its destination, 
the userid portion of the original routing is lost. 


Rnonn 

RMnnnon 

RMTnnonn 
Identifies a remote terminal. nnnn is | through 4 decimal numbers from 1 through 9999. 
Note that with remote pooling, the installation may translate this route code to another 
route code. 


Note: RO is equivalent to LOCAL. 
Unnnn 


Identifies a local terminal with special routing. nnnn is 1 through 4 decimal numbers 
from | through 9999. 


Subparameter Definition for JES3 Systems 


ANYLOCAL 
Indicates any local device. 


device-name 
Identifies a local device by a symbolic name defined by the installation during JES3 
initialization. device-name is 1 through 8 alphanumeric or national ($, #, @) characters. 


group-name 
Identifies a group of local devices, an individual remote station, or a group of remote 
stations by a symbolic name defined by the installation during JES3 initialization. 
group-name is 1 through 8 alphanumeric or national ($, #, @) characters. 


nodename 
Identifies a node by a symbolic name defined by the installation during JES3 
initialization. The node is | through 8 alphanumeric or national ($, #, @) characters. If 
the node you specify is the same as the node you are working on, JES3 treats the output 
as though you had specified ANYLOCAL. 


nodename.userid 
Identifies a destination node and a VM or TSO userid at that node. The nodename is a 
symbolic name defined by the installation during initialization. The userid must be 
defined at the node. A userid requires a node; therefore, code DEST = nodename.userid. 
Do not code a userid without a node. 
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Defaults 
If you do not code a DEST parameter, JES directs the sysout data set to the default destination » 
for the input device from which the job was submitted. 
If a specified destination is invalid, the job fails. 

Overrides 


A DEST parameter on the sysout DD statement overrides the OUTPUT JCL DEST parameter. 


Relationship to Other Parameters 


For JES3, you can code the DEST = nodename parameter with the OUTPUT JCL 
WRITER = name parameter; however, do not code DEST = nodename.userid with 
WRITER = name. 


Examples of the DEST Parameter 


//REMOT1 OUTPUT DEST=R444 
In this example, JES2 sends the sysout data set to remote terminal 444. 


//REMOT2 OUTPUT DEST=STAT444 


In this example, JES sends the sysout data set to an individual remote station named by the 
installation STAT444. 


//REMOT3 OUTPUT DEST=KOKVMBB8 .DP58HHHD 


In this example, JES sends the sysout data set to VM userid DPS8HHHD at node 
KOK VMBBS8. 
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FCB Parameter 


Parameter Type: Keyword, optional 
Purpose: Use the FCB parameter to specify: 


e The forms control buffer (FCB) image JES is to use to guide printing of the sysout data set 
by a 1403 Printer, 3211 Printer, 3203 Printer Model 5, 3800 Printing Subsystem, 4245 
Printer, or 4248 Printer, or by a printer supported by systems network architecture (SNA) 
remote job entry (RJE). 


e The carriage control tape JES is to use to control printing of the sysout data set by a 1403 
Printer or by a printer supported by SNA RJE. 


e The data-protection image JES is to use to control output by a 3525 Card Punch. 
The FCB image specifies how many lines are to be printed per inch and the length of the form. 
JES loads the image into the printer’s forms control buffer. The FCB image is stored in 
SYS1.IMAGELIB. IBM provides three standard FCB images: 
e STD1, which specifies 6 lines per inch on an 8.5-inch-long form. (3211 and 3203-5 only) 
e STD2, which specifies 6 lines per inch on an 11-inch-long form. (3211 and 3203-5 only) 
e STD3, which in a JES3 system specifies 8 lines per inch for a dump. (3800 only) 
References: For more information on the forms control buffer, see: 
MVS/XA System-Data Administration, 
Programming Support for the IBM 3505 Card Reader and IBM 3525 Card Punch, or 
3800 Printing Subsystem Programmer's Guide. 


Syntax: 


FCB= |£fcb-name 
STD 


@ Code the fcb-name as STD1 or STD2 only to request the IBM-supplied images. 
e Code the fcb-name as STD3 only for a high-density dump in a JES3 system. 


Subparameter Definition 


fcb-name 
Identifies the FCB image. The name is | through 4 alphanumeric or national ($, #, @) 
characters and is the last characters of a SYS1.[MAGELIB member name: 


e FCB2xxxx member, for a 3211, a 3203 Model 5, or a printer supported by SNA. 


@e FCB3xxxx member, for a 3800. 
e FCB4xxxx member, for a 4248. 
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STD 
Indicates the standard FCB. JES3 uses the standard FCB specified at JES3 initialization. 


Note: STD is supported only on JES3 systems. 


Defaults 
If you do not code the FCB parameter, the system checks the FCB image in the printer’s forms 
control buffer; if it is a default image, as indicated by its first byte, JES uses it. If it is nota 
default image, JES loads the FCB image that is the installation default specified at JES 
initialization. 

Overrides 


An FCB parameter on the sysout DD statement overrides the OUTPUT JCL FCB parameter. 


Relationship to Other Parameters 


The FCB parameter is mutually exclusive with the FRID subparameter of the DD statement 
DCB parameter. 


Requesting a High-Density Dump 


You can request a high-density dump on the 3800 through two parameters on the DD 
statement for the dump data set or on an OUTPUT JCL statement referenced by the dump DD 
statement: 


e FCB=STD3. This parameter produces dump output at 8 lines per inch. 
e CHARS=DUMP. This parameter produces 204-character print lines. 


You can code one or both of these parameters. You can place both on the same statement or 
one on each statement. 


Example of the FCB Parameter 


//OUTDS1 OUTPUT FCB=AA33 


In this example, JES will print the sysout data set using the FCB image named AA33. 
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FLASH Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the FLASH parameter to identify the forms overlay to be used in printing the 
sysout data set on a 3800 Printing Subsystem and, optionally, to specify the number of copies 
on which the forms overlay is to be printed. 


Note: FLASH applies only for a data set printed on a 3800. 


References: For information on forms overlays, see the Forms Design Reference Guide for the 
IBM 3800 Printing Subsystem. 


Syntax: 


overlay-name 

FLASH= | (overlay-name[,count] ) 
(,count ) 
NONE 


STD 


The count subparameter is optional. If you omit it, you can omit the parentheses. 


Subparameter Definition 


overlay-name 
Identifies the forms overlay frame that the operator is to insert into the printer before 
printing begins. The name is | through 4 alphanumeric or national ($, #, @) characters. 


count 
Specifies the number, 0 through 255, of copies that JES is to flash with the overlay, 
beginning with the first copy printed. Code a count of 0 to flash no copies. 


NONE 
Suppresses flashing for this sysout data set. 


If FLASH = NONE is on an OUTPUT JCL statement in a job to be executed at a remote 
node, JES3 sets the overlay-name to zero before sending the job to the node. 


STD 
Indicates the standard forms flash overlay. JES3 uses the standard forms overlay 


specified at JES3 initialization. 


Note: STD is supported only on JES3 systems. 
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Defaults 
If you do not code a FLASH parameter or an installation default was not specified at JES2 or 
JES3 initialization, forms are not flashed. 
If you specify an overlay-name without specifying a count, all copies are flashed. That is, the 
default for count is 255. 

Overrides 


A FLASH parameter on the sysout DD statement overrides the OUTPUT JCL FLASH 
parameter. 


Relationship to Other Parameters 


If the OUTPUT JCL or the sysout DD statement also contains a COPIES parameter, JES 
prints with the forms overlay the number of copies specified in one of the following: 


e COPIES=nnn, if the FLASH count is larger than nnn. For example, if COPIES=10 and 
FLASH =(LTHD,12) JES prints 10 copies, all with the forms overlay. 


e The sum of the group-values specified in the COPIES parameter, if the FLASH count is 
larger than the sum. For example, if COPIES =(,(2,3,4)) and FLASH =(LTHD,12) JES 
prints nine copies in groups, all with the forms overlay. 

e The count subparameter in the FLASH parameter, if the FLASH count is smaller than nnn 
or the sum from the COPIES parameter. For example, if COPIES = 10 and 


FLASH =(LTHD,7) JES prints seven copies with the forms overlay and three copies 
without. 


Verification of Forms Overlay Frame 
Before printing starts, the system requests the operator to load the specified forms overlay 


frame in the printer. A frame must be loaded but the system cannot verify that it is the correct 
frame. ? 


Printing without Flashing 
To print without flashing, specify one of the following: 
e FLASH=NONE on the DD or OUTPUT JCL statement. 


e Omit the FLASH parameter on all of the statements for the data set and on all JES 
initialization statements. 


e FLASH=(,0) on the OUTPUT JCL statement. 


17-36 MVS/XA JCL Reference 


OUTPUT JCL: FLASH 


Example of the FLASH Parameter 


//OUTDS1 OUTPUT COPIES=16 , FLASH=(LTHD,7) 


In this example, JES issues a message to the operator requesting that the forms overlay frame 
named LTHD be inserted in the printer. Then JES prints the first seven copies of the sysout 
data set with the forms overlay and the last nine without. 
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FORMDEF Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the FORMDEF parameter to identify a library member that contains statements 
to tell the Print Services Facility (PSF) how to print the sysout data set on a page-mode printer 
(such as the 3800 Printing Subsystem Model 3). The statements can specify the following: 


@ Overlay forms to be used during printing. 
e Location on the page where overlays are to be placed. 
e Suppressions that can be activated for specified page formats. 


The member must be in the library named in the cataloged procedure that was used to initialize 
the PSF. 


Note: FORMDEF applies only for data sets printed on a page-mode printer (such as the 3800 


Model 3). | ) 


References: For more information, see Print Management Facility User's Guide and Reference 
and 3800 Printing Subsystem Programmer's Guide. 


Syntax: 


FORMDEF=membername 


Subparameter Definition 


membername 
Specifies the name of a library member. membername is | through 6 alphanumeric or 
national ($, #, @) characters; the first two characters are pre-defined by the system. 


Overrides J 


The library member specified by the OUTPUT JCL FORMDEF parameter can contain: 


e Statements that override the installation’s FORMDEF defaults in the PSF cataloged 
procedure. 


e A FORMDEF statement with a COPYGROUP parameter. The COPYGROUP parameter 
overrides any group-value subparameters on the OUTPUT JCL COPIES parameter or the 
sysout DD COPIES parameter. 


Note: The FORMDEF statement in the library member does not override a sysout DD or 
OUTPUT JCL COPIES = nnn parameter. 
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Example of the FORMDEF Parameter 


//PRINT3 OUTPUT FORMDEF=JJPRT 


In this example, PSF is to print the sysout data set on a 3800 Model 3 according to the 
parameters in the library member JJPRT. 
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FORMS Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the FORMS parameter to identify the forms on which the sysout data set is to 
be printed or punched. 


Syntax: 


FORMS= jform-name 


STD 


Subparameter Definition 
form-name 
Identifies the print or punch forms. form-name is 1 through 8 alphanumeric or national 


($, #, @) characters. 


STD 
Indicates that JES3 is to use the standard form specified at JES3 initialization. 


Note: STD is supported only on JES3 systems. 


Defaults 
If you do not code a form-name subparameter, JES uses an installation default specified at 
initialization. 

Overrides 
The form-name subparameter of the SYSOUT parameter on the sysout DD statement overrides 
the OUTPUT JCL FORMS parameter. Note that the SYSOUT form-name subparameter can 


be only four characters maximum while both the OUTPUT JCL FORMS form-name and the 
JES initialization default form names can be eight characters maximum. 


Example of the FORMS Parameter 


//OUTDS1 OUTPUT FORMS=ACCT4010 


In this example, the sysout data set will be printed on forms named ACCT4010. 
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GROUPID Parameter 


Parameter Type: Keyword, optional, JES2 only 

Purpose: Use the GROUPID parameter to specify that the sysout data set belongs to an 
output group. The data sets in an output group are processed together in the same location 
and time. Data sets to be grouped should have similar characteristics: the same output class, 
destination, process mode, and external writer name. 


Note: GROUPID is supported only on JES2 systems. 


Syntax: 


GROUPID=output-group 


Subparameter Definition 


output-group 
Specifies the name of an output group. The output-group is 1 through 8 alphanumeric 
characters and is selected by the programmer to define an output group for this job. The 
name is not installation-defined. 


Relationship to Other Control Statements 


If you code FREE=CLOSE on a sysout DD statement that references an OUTPUT JCL 
statement containing a GROUPID parameter, JES2 will not group the data sets into one 
output group. Instead, JES2 produces one copy of the sysout data set for each OUTPUT JCL 
statement that the DD statement references. 
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Examples of the GROUPID Parameter 


//EXMP5 JOB ACCT1984 ,MAEBIRD ,MSGCLASS=A 
//OUTRPT OUTPUT GROUPID=RPTGP , DEFAULT=YES , DEST=TDC 
//STEP1 EXEC PGM=RPTWRIT 

//SYSIN DD * 

j* 

//RPTDLY DD SYSOUT=C 

//RPTWK DD SYSOUT=C 


In this example, the DD statements RPTDLY and RPTWK implicitly reference the default 
OUTPUT JCL statement OUTRPT. JES2 creates two output groups: 


1. Group RPTGP is created because of the GROUPID parameter in the OUTPUT JCL 


statement. It contains the two reports from the sysout DD statements RPTDLY and } 
RPTWK and is printed at the destination TDC. The programmer named this group | 
RPTGP. 


2. The other group is named by JES2. It contains the system-managed data set for the job’s 


messages. 

/ /EXAMP JOB MSGCLASS=A 

//JOBOUT OUTPUT GROUPID=SUMM, DEST=HQS , CHARS=GT10 | 
//STEP1 EXEC PGM=RWRITE } 
//OUT1 OUTPUT FORMS=STD,CHARS=GS10,DEST=LOCAL 

//RPT1 DD SYSOUT=A, OUTPUT=(* .OUT1,*.JOBOUT) 

//STEP2 EXEC PGM=SWRITE 

//OUT2 OUTPUT FORMS=111,CHARS=GB10 , DEST=LOCAL 

//RPT2 DD SYSOUT=B , OUTPUT=(* .OUT2 ,*.JOBOUT) 


This job causes JES2 to produce five sets of output: 


1.1.1, containing the system-managed data sets. This set is specified through the JOB 
statement MSGCLASS parameter. 


SUMM.1.1, containing a copy of the data set defined by DD statement RPT1. This set is 
specified through the second OUTPUT subparameter: *.JOBOUT. It is for output class 
A. 


SUMM.2.1, containing a copy of the data set defined by DD statement RPT2. This set is 
specified through the second OUTPUT subparameter: *.JOBOUT. Because it is for 
output class B, it is in a separate subgroup from the SUMM.1.1 subgroup. 


4.1.1, containing a copy of the data set defined by DD statement RPT1. This set is 
specified through the first OUTPUT subparameter: *.OUT1. 


5.1.1, containing a copy of the data set defined by DD statement RPT2. This set is 
specified through the firsts OUTPUT subparameter: *.OUT2. 
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INDEX Parameter 


Parameter Type: Keyword, optional, JES2 only 


Purpose: Use the INDEX parameter to set the left margin for output on a 3211 Printer with 
the indexing feature. The width of the print line is reduced by the INDEX parameter value. 


Note: INDEX is supported only on JES2 systems and only for output printed on a 3211 with 
the indexing feature. JES2 ignores the INDEX parameter if the printer is not a 3211 with the 


indexing feature. 


Syntax: 


INDEX=nn 


Subparameter Definition 
nn 
Specifies how many print positions the left margin on the 3211 output is to be indented. 


nn is a decimal number from 1 through 31. n=1 indicates flush-left; n=2 through n=31 
indent the print line by n-1 positions. 


Defaults 


The default is 1, which indicates flush left. Thus, if you do not code an INDEX or LINDEX 
parameter, JES2 prints full-width lines. 


Relationship to Other Parameters 


INDEX and LINDEX are mutually exclusive; if you code both, JES2 uses the last one 
encountered. Note that you cannot index both the left and right margins. 


Example of the INDEX Parameter 


//OUT17 OUTPUT INDEX=6 


In this example, because the printed report is to be stapled, extra space is needed on the left. 
Assuming the data set is printed on a 3211 with the indexing feature, all lines are indented 5 
print positions from the left page margin. 
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JESDS Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the JESDS parameter to process the job’s system-managed data sets according to 
the parameters on this OUTPUT JCL statement. The system-managed data sets consist of: 


@ The job log, which is a record of job-related information for the programmer. Printing of 
the job log is controlled by two JOB statement parameters: the MSGLEVEL parameter 
controls what is printed and the MSGCLASS parameter controls the system output class. 


@ The job’s hard-copy log, which is a record of all message traffic for the job to and from the 
operator console. 


e System messages for the job. 
References: For more information on the job log, see System Commands. 


Syntax: 


JESDS= (ALL 


Subparameter Definition 


ALL 
Indicates all of the job’s system-managed data sets. 


JCL 
Indicates all job control statements in the input stream, that is, all JCL statements and 
JES2 or JES3 statements, plus all procedure statements from any in-stream or cataloged 
procedure a job step calls, plus all messages about job control statements. 


LOG 
Indicates the job’s hard-copy log, which contains the JES and operator messages about 
the job’s processing: allocation of devices and volumes, execution and termination of job 
steps and the job, and disposition of data sets. 


MSG 
Indicates any system messages for this job. 
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Overrides 


The NOLOG parameter on a JES2 /*JOBPARM statement overrides the OUTPUT JCL 
JESDS=ALL parameter. 


Location in the JCL 
Place an OUTPUT JCL statement containing JESDS before the first EXEC statement of the 
job. An OUTPUT JCL statement containing JESDS placed after an EXEC statement is a JCL 


error. 


You can place more than one OUTPUT JCL statement containing JESDS before the first 
EXEC statement. JES creates a copy of the job’s system data sets for each. 


Destination for the System Data Sets 
If you want the job’s system data sets processed at a particular destination, code a DEST 


parameter on the OUTPUT JCL statement containing JESDS. Otherwise, JES routes the 
system data sets to a local device. 


JES2 Processing with JESDS 


JES2 processes OUTPUT JCL statements for system-managed data sets (JESDS parameter) 
only if a job completes execution. 


System-managed data sets are not processed for the following jobs because the jobs do not 
complete execution: 


e Jobs that specify a TYPRUN value on the JOB statement that prevents execution, such as 
COPY or SCAN. 


e Jobs that do not execute because of a JCL error, an error in a JES2 control statement, or a 
system failure in JES2 input processing. 


e Jobs that reach execution but do not complete execution because an MVS system failure 
occurs that requires an IPL. 


| JES3 Processing with JESDS 


| System-managed data sets are not processed by JES3 for the following jobs because the jobs do 
| not complete execution: 


| e Jobs that specify a TYPRUN value on the JOB statement that prevents execution, such as 
| SCAN. 


| e Jobs that do not execute because of a JCL error. 
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Example of the JESDS Parameter 


/ /EXMP JOB MSGCLASS=A 
//OUT1 OUTPUT JESDS=ALL 


/ /OUT2 OUTPUT JESDS=ALL,DEST=AUSTIN 


In this example, JES produces two copies of the system-managed data sets: one copy for 
OUTPUT JCL statement OUT1 and one copy for OUTPUT JCL statement OUT2. The copy 
for statement OUT2 is sent to AUSTIN. 
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LINDEX Parameter 


Parameter Type: Keyword, optional, JES2 only 

Purpose: Use the LINDEX parameter to set the right margin for output on a 3211 Printer 
with the indexing feature. The width of the print line is reduced by the LINDEX parameter 
value. 

Note: LINDEX 1s supported only on JES2 systems and only for output printed on a 3211 with 
the indexing feature. JES2 ignores the LINDEX parameter if the printer is not a 3211 with the 
indexing feature. 


Syntax: 


LINDEX=nn 


Subparameter Definition 


Defaults 


nn 
Specifies how many print positions the right margin on the 3211 output is to be moved in 
from the full page width. nn is a decimal number from 1 through 31. n=1 indicates 
flush-right; n=2 through n=31 move the right margin over by n-1 positions. 


The default is 1, which indicates flush nght. Thus, if you do not code an INDEX or LINDEX 
parameter, JES2 prints full-width lines. 


Relationship to Other Parameters 


INDEX and LINDEX are mutually exclusive; if you code both, JES2 uses the last one 
encountered. Note that you cannot index both the left and right margins. 


Example of the LINDEX Parameter 


//OUT18 OUTPUT LINDEX=21 
In this example, the author of the report wanted extra space on the right side of the paper for 


notes. Assuming the data set is printed on a 3211 with the indexing feature, all lines are ended 
20 print positions from the right page margin. 
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LINECT Parameter 


Parameter Type: Keyword, optional, JES2 only 


Purpose: Use the LINECT parameter to specify the maximum number of lines JES2 is to print 
on each output page. 


Note: LINECT is supported only on JES2 systems. 


Syntax: 


LINECT=nnn 


Subparameter Definition 


non 
Specifies the maximum number of lines JES2 is to print on each page. nnn is a number 
from 0 through 255. 


Specify LINECT =0 to keep JES2 from starting a new page when the number of lines 
exceeds the JES2 initialization parameter. 


Defaults 


If you do not code the LINECT parameter, JES2 obtains the value from one of the following 
sources, in order: 


1. The linect field of the accounting information parameter on the JOB statement. 
2. The installation default specified at JES2 initialization. 


Example of the LINECT Parameter 


//PRNTDS OUTPUT LINECT=45 


In this example, JES2 will start a new page after every 45 lines. 
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MODIFY Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the MODIFY parameter to specify a copy-modification module that tells JES 
how to print the sysout data set on a 3800 Printing Subsystem. The module can specify the 
following: 


e Legends. 
e Column headings. 
@ Where and on which copies the data is to be printed. 


The module is defined and stored in SYS1.IMAGELIB using the IEBIMAGE utility program. 
Note: MODIFY applies only for the 3800 Printing Subsystem Model | and 2 and the 3800 
Printing Subsystem Model 3, 6 and 8 in compatibility mode. For page-mode printers (such as 


the 3800 Model 3), use the FORMDEF and PAGEDEF parameters to obtain the same 
functions. 


References: For more information on the copy modification module and the IEBIMAGE 
utility program, see Data Administration: Utilities. 


Syntax: 
MODIFY= Jmodule-name 


([module-name] [,trc]) 


You can omit the module-name, thereby obtaining the initialization default. For 
example, MODIFY =(,2). 


The trc subparameter is optional. If you omit it, you can omit the parentheses. 


Subparameter Definition 
module-name 


Identifies a copy-modification module in SYS].IMAGELIB. The module-name is 1 
through 4 alphanumeric or national ($, #, @) characters. 
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tre 
Identifies which character-arrangement table named in the CHARS parameter is to be 
used. This table reference character is 0 for the first table-name specified, | for the 
second, 2 for the third, or 3 for the fourth. The CHARS parameter used is on the 
following, in override order: 


1. The DD statement. 
2. This OUTPUT JCL statement. 


3. A statement in the library member specified on the OUTPUT JCL PAGEDEF 
parameter. 


4. A statement in the SYS1..LMAGELIB member obtained by default. 


5. A JES3 initialization statement. 


Defaults J 


If you do not code module-name in the MODIFY parameter, JES3 uses an installation default 
specified at initialization. JES2 provides no installation default at initialization. 


If you do not specify tre, the default is 0. If the tre value is greater than the number of 
table-names in the CHARS parameter, JES2 uses the first character-arrangement table named 
in the CHARS parameter and JES3 uses the last character-arrangement table named in the 


CHARS parameter. } 


Overrides 


A MODIFY parameter on the sysout DD statement overrides the OUTPUT JCL MODIFY 
parameter. 


Relationship to Other Parameters 


The second character of each logical record can be a TRC code, so that each record can be | ; 
printed in a different font. This way of specifying fonts is indicated by the OUTPUT JCL TRC 
parameter. 


Example of the MODIFY Parameter 


//OUTDS1 OUTPUT CHARS=(GT12,GB12,GI12) ,MODIFY=(MODA, 2) 


In this example, JES loads the MODA module in SYS1.IMAGELIB into the 3800 and uses 
GI12, Gothic Italic 12-pitch font, which is the third table name specified in the CHARS 
parameter. 
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PAGEDEF Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the PAGEDEF parameter to identify a library member that contains statements 
to tell the Print Services Facility (PSF) how to print the sysout data set on a page-mode printer 
(such as a 3800 Printing Subsystem Model 3). The statements can specify the following: 


Logical page length and width. 

Fonts. 

Page segments. 

Multiple page types or formats. 

Lines within a page; for example: 

— Line origin. 

— Carriage controls. 

— Spacing. 

@e Multiple logical pages on a physical page. 


The member must be in the library named in the cataloged procedure that was used to initialize 
the PSF. 


Note: PAGEDEF applies only for data sets printed on a page-mode printer (such as a 3800 
Model 3). 


References: For more information, see Print Management Facility User's Guide and Reference 
and 3800 Printing Subsystem Programmer's Guide. 


Syntax: 


PAGEDEF=membername 


Subparameter Definition 
membername 


Specifies the name of the library member. membername is | through 6 alphanumeric or 
national ($, #, @) characters; the first two characters are pre-defined by the system. 
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Overrides 


The statements in the library member specified by the OUTPUT JCL PAGEDEF parameter 2 
override the installation’s PAGEDEF defaults in the PSF cataloged procedure. 


The PSF uses the following parameters, in override order, to select the font list: 


Font list in the library member specified by an OUTPUT JCL PAGEDEF parameter. 
DD CHARS parameter. 

OUTPUT JCL CHARS parameter. 

DD UCS parameter. 

OUTPUT JCL UCS parameter. 

JES installation default for the device. 

Font list on the PAGEDEF parameter in the PSF cataloged procedure. 


Se 


Example of the PAGEDEF Parameter 


//OUTDS1 OUTPUT PRMODE=PAGE , PAGEDEF=SSPGE 


In this example, PSF is to print the sysout data set on a 3800 Model 3 operating in page mode. 
The printing is to be done according to the parameters in the library member SSPGE. 
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PIMSG Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the PIMSG parameter to indicate the handling of messages by the functional 
subsystem Print Services Facility (PSF). PIMSG is used to specify whether all error messages 
are to be printed, and the number of errors sufficient to cause the printing of the data set to be 
terminated. 


The functional subsystem PSF accumulates messages in the PSF address space for errors that 
occur while processing line-mode and page-mode data sets. 


When you code PIMSG= YES, the system prints all these messages at the end of the output 
data set. 


When you code PIMSG=NO, no messages are printed unless there is an error that forces 
premature termination of the printing of the data set. If an error occurs, the system prints the 
set of messages (called a message group) associated with the error that caused the termination. 


As errors are detected by PSF or reported to PSF by the printer, a count is kept of the 
associated message groups. When the count equals the number specified on the PIMSG 
parameter, PSF terminates the printing of the current data set. PSF interprets a count of zero 
as infinite, and does not terminate the printing of the data set on the basis of the number of 
errors detected. 


Note: PIMSG can be specified only for data sets printed through PSF. 


Syntax: 


PIMSG= | (YES|,msg-count] ) 
(NO[,msg-count] ) 


e You can omit the parentheses if you do not specify msg-count. 


Subparameter Definition 


YES 
Requests that the system print all messages generated by the functional subsystem. This 
subparameter can also be coded as Y. 


NO 
Requests that the system print no error messages, except if the printing of the data set 1s 
prematurely terminated. If a terminating error occurs, only the set of messages (called a 
message group) associated with the error that caused the termination is printed. This 
subparameter can also be coded as N. 


msg-count 
Requests that the system cancel the printing of the current data set after the specified 
number of errors (as represented by the associated message groups) have been detected by 
PSF or reported to PSF by the printer. In this context, errors refers to data-stream 
errors, and errors resulting from any malfunction that would cause the printer to halt, 
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such as a mechanism failure, or out-of-paper condition. However, these errors do not 
include those caused by operator intervention. 


Valid values for msg-count are 0-999, where 0 is interpreted as infinite. 


The types of errors that increment the message count are those that induce a message 
group to be printed at the end of the data set. However, even though the printing of the 
message groups is inhibited by PIMSG=NO, the associated error still increments the 
message count. (A message group consists of a primary message and variable number of 
informational messages that result from a single error.) 


In the case that multiple transmissions have been specified for a single data set 
(user-specified multiple copies), the message count would apply on a per copy basis. If 
the specified number of errors are discovered during the printing of any copy, the subject 
copy is terminated, and the remaining copies are not printed. 


Defaults 


If you do not code the PIMSG parameter, the PIMSG specification from the PSF PRINTDEV 
statement applies. If not specified in the PRINTDEV statement, the default is 
PIMSG = (YES, 16). 


Relationship to Other Statements 


You can request a dump of specific PSF control blocks, by specifying the DUMP parameter on 

the PRINTDEV statement of the PSF start-up procedure (see Print Services Facility System ; 
Programmer's Guide for MVS). This dump can be conditional upon a specific PSF message 

identifier. 


Turning error messages off with PIMSG=NO does not inhibit this dump facility. 
For example, if PIMSG =(NO,5) is specified and the fifth qualifying error is also the error 


designated by the DUMP parameter on the PRINTDEV statement, PSF captures the dump 
information before terminating the printing of the current data set. 


Examples of the PIMSG Parameter 


//OUTDS2 OUTPUT DATACK=UNBLOCK, PIMSG=(YES,0) 


In this example, regardless of how many message-generating errors are detected by PSF or 
reported to PSF by the printer, the printing of the current data set continues to completion or 
until a terminating error is encountered. All the messages are printed by the system. 


//OUTDS2 OUTPUT DATACK=UNBLOCK, PIMSG=(NO,5) 
In this example, after five message-generating errors are detected by PSF or reported to PSF by 


the printer, the printing of the current data set is terminated. Only the last message group is 
printed by the system. 
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PRMODE Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the PRMODE parameter to identify the process mode required to print the 
sysout data set. JES schedules the data set to a printer that can operate in the specified mode. 


For a list of valid process modes, contact your system programmer. 


Syntax: 


PAGE 
process-mode 


PRMODE= ac | 


Subparameter Definition 


LINE 
Indicates that the data set is to be scheduled to a line-mode printer. 


PAGE 
Indicates that the data set is to be scheduled to a page-mode printer. 


process-mode 
Specifies the required process mode. The process-mode is 1 through 8 alphanumeric 


characters. 


For an NJE-transmitted data set, use PRMODE to request specific processing without 
having to obtain output classes for the node that processes the data set. 


Defaults 
If you do not code the PRMODE parameter, JES schedules output processing as follows: 


e If the sysout data set does not contain page-mode formatting controls, the process mode of 
line 1s given to the data set. 


e If the sysout data set contains page-mode formatting controls, the process mode of page is 
given to the data set. 


Printing a Line-Mode Data Set Using PSF 


To print a line-mode data set using the Print Services Facility (PSF) and the enhanced 
capabilities of the 3800 Model 3, 6 and 8, code PRMODE=PAGE. The PSF formats this 
line-mode data set using the installation’s default values for PAGEDEF and FORMDEF 
defined in the PSF cataloged procedure; if these defaults are unsatisfactory, code the 
PAGEDEF and FORMDEF parameters on the OUTPUT JCL statement. 
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Example of the PRMODE Parameter 


//DS18 OUTPUT PRMODE=LINE 


In this example, JES schedules the sysout data set to a printer with a process mode of line. 
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PRTY Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the PRTY parameter to specify the priority at which the sysout data set enters 
the output queue. A data set with a higher priority is printed sooner. 


Syntax: 


PRTY=nnn 


Subparameter Definition 


Defaults 


Overrides 


non 
Specifies the initial priority. nnn is a decimal number from 0 through 255; 0 is the lowest 
priority while 255 is the highest. 


If you do not code the PRTY parameter, JES3 uses an installation default specified at 
initialization. JES2 uses a priority that is calculated for all output. 


In JES2 systems, the installation can specify at JES2 initialization that JES2 is to ignore the 
OUTPUT JCL PRTY parameter. 


In JES3 systems, the OUTPUT JCL PRTY parameter is ignored for JES3 networking. 


Example of the PRTY Parameter 


//PRESRPT OUTPUT PRTY=200, FORMS=TOPSEC 
In this example, JES prints one copy of the president’s report, PRESRPT, on forms named 


TOPSEC. Because a priority of 200 is specified, the report is probably printed immediately 
after entering the output queue. 
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THRESHLD Parameter 


Parameter Type: Keyword, optional, JES3 only 


Purpose: Use the THRESHLD parameter to specify the maximum size for the sysout data set. 
JES3 calculates the sysout data set size as the number of records multiplied by the number of 
copies requested. When this size exceeds the THRESHLD value, JES3 creates a new unit of 
work, on a data set boundary, and queues it for printing. Consequently, copies of the sysout 
data set may be printed simultaneously by different printers. 


Use the THRESHLD parameter for jobs that generate many large data sets or many copies of 
one large data set. 


Note: THRESHLD is supported only on JES3 systems. 


Syntax: 


THRESHLD=1limit 


Subparameter Definition 
limit 
Specifies the maximum number of records for a single sysout data set. limit is a decimal 
number from 1 through 99999999. ) 


Defaults 


If you do not code the THRESHLD parameter, JES3 uses an installation default specified at 
initialization. 
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| Example of the THRESHLD Parameter 
//STEPA EXEC PGM=RPTWRT 
//SY¥SDS3 OUTPUT DEFAULT=YES , THRESHLD=10000 


//RPT1 DD SYSOUT=A , COPIES=10 
//RPT2 ODD SYSOUT=A , COPIES=2 
//RPT3 DD SYSOUT=A ,COPIES=5 


In this example, the report data sets, RPT1, RPT2, and RPT3, are processed in sysout class A. 
All three DD statements implicitly reference the step-level default OUTPUT JCL statement 
SYSDS3; therefore, the THRESHLD value specified in the OUTPUT JCL statement applies to 
the three reports combined. JES3 is to print the following: 


Data Records in Total 
Copies Set Data Set Records 
10 RPT1 1000 10000 
j P RPT2 2000 4000 
5 RPT3 500 2500 


Total 16500 


Because the total exceeds the THRESHLD limit, JES3 divides the sysout data sets into two 
units of work. RPT1 is printed as one unit, and the other two data sets are printed together as 
another unit. If the THRESHLD limit had been 20000, all three data sets would have been 
printed as one unit of work. 
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TRC Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the TRC parameter to specify whether the logical record for each output line in 
the sysout data set contains table reference character (TRC) codes or not. The TRC code 
identifies which table-name in the CHARS parameter is to be used to print the record. 


If present, a TRC code in the output line record is: 


@ The first byte, if a carriage control character is not used. 
e The second byte, immediately following the carriage control character, if used. 


Note: TRC is supported only on JES3 systems. However, in a JES2 system, TRC can be 
specified for a data set processed in a functional subsystem address space (FSA); JES2 passes 
the TRC parameter value to the FSA. Thus, TRC can be specified for a data set printed on a 
3800 Printing Subsystem Model 3, 6, and 8 by the Print Services Facility (PSF). 


Syntax: 
TRC= (YES 
Y 
NO 
N 


Subparameter Definition 
YES 
Indicates that the data set contains TRC codes. This subparameter can also be coded as 
Y: 
NO 


Indicates that the data set does not contain TRC codes. This subparameter can also be 
coded as N. 


Defaults 


If you do not code the TRC parameter, the default is NO. 


Relationship to Other Parameters 


A table reference character for the entire data set can be specified in the OUTPUT JCL 
MODIFY parameter. 
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Example of the TRC Parameter 


C 


//WRTR JOB ACNO77 ,MAEBIRD ,MSGCLASS=B 

//DS23 OUTPUT DEFAULT=YES , FORMS=STD , CONTROL=PROGRAM , TRC=YES 
//STEP1 EXEC PGM=DLYRPT 

//DAILY DD SYSOUT=A, CHARS=(GT12,GB12,GI12) 


In this example, sysout DD statement DAILY implicitly references the default job-level 
OUTPUT JCL statement DS23. This OUTPUT JCL statement directs JES3 to print the daily 
report on standard forms. The sysout data set defined by DD statement DAILY contains 
carriage control characters in the first character of each logical record and a TRC code in the 
second character. The TRC characters in the records are 0 to use the font GT12; | to use 
GB12; and 2 to use GI12. 
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UCS Parameter 


Parameter Type: Keyword, optional 
Purpose: Use the UCS parameter to identify: 
@ The universal character set (UCS) image JES is to use in printing the sysout data set. 


e A print train (print chain or print band) JES is to use in printing the sysout data set on an 
impact printer. 


e A character-arrangement table for the sysout data set printed on a 3800 Printing Subsystem 
in a JES2 system. In this use, the UCS parameter acts like a CHARS parameter. 


The UCS image specifies the special character set to be used. JES loads the image into the 
printer’s buffer. The UCS image is stored in SYS1.[.MAGELIB. IBM provides the special 
character set codes in Figure 17-2. 


References: For more information on the UCS parameter, see System-Data Administration. 


Syntax: 


UCS=character-set-code 


Subparameter Definition 


Defaults 


character-set-code 
Identifies a universal character set. The character-set-code is 1 through 4 alphanumeric or 
national ($, #, @) characters. See Figure 17-2 for IBM standard special character set 
codes. 


If you do not code the UCS parameter, the system checks the UCS image in the printer’s 
buffer; if it is a default image, as indicated by its first byte, JES uses it. If it is not a default 
image, JES loads the UCS image that is the installation default specified at JES initialization. 


On an impact printer, if the chain or train does not contain a valid character set, JES asks the 
operator to specify a character set and to mount the corresponding chain or train. 
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3203 Characteristics 
Model 5 


Arrangement A, standard EBCDIC character set, 48 characters 
Arrangement H, EBCDIC character set for FORTRAN and COBOL, 48 characters 
ASCII character set 

Preferred alphanumeric character set, arrangement A 

Preferred alphanumeric character set, arrangement H 

PL/I alphanumeric character set 

PL/I preferred alphanumeric character set for scientific applications 

PL/1 preferred alphanumeric character set for commercial applications 

Preferred character set for commercial applications of FORTRAN and COBOL 
Preferred character set for text printing 

Character set for text printing, 120 characters 

High-speed alphanumeric character set for 1403, Model 2 
High-speed preferred alphanumeric character set for 1403, Model N1 


Note: Where three values exist (for the 1403, 3211, and 3203 Model 5 printers), code any one of them. JES selects 
the set corresponding to the device on which the data set is printed. 


Not all of these character sets may be available at your installation. Also, an installation can design character sets 
to meet special needs and assign a unique code to them. Follow installation procedures for using character sets. 


Figure 17-2. Special Character Sets for the 1403, 3203 Model 5, and 3211 Printers 


Overrides 


For printing on a printer with the UCS feature, a UCS parameter on the sysout DD statement 
overrides the OUTPUT JCL UCS parameter. For printing on a 3800, a CHARS parameter on 
the sysout DD statement or the OUTPUT JCL statement overrides all UCS parameters. 


For a data set scheduled to the Print Services Facility (PSF), the PSF uses the following 
parameters, in override order, to select the font list: 


Font list in the library member specified by an OUTPUT JCL PAGEDEF parameter. 
DD CHARS parameter. 

OUTPUT JCL CHARS parameter. 

DD UCS parameter. 

OUTPUT JCL UCS parameter. 

JES installation default for the device. 

Font list on the PAGEDEF parameter in the PSF cataloged procedure. 


So Ae 


See “PAGEDEF Parameter” on page 17-51 for more information. 


Using Special Characters Sets 
To use a special character set, SYS1.IMAGELIB must contain an image of the character set, 


and the chain or train for the character set must be available. IBM provides standard special 
character sets, and the installation may provide user-designed special character sets. 
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OUTPUT JCL: UCS 


Example of the UCS Parameter 


//PRTDS9 OUTPUT UCS=A11 


In this example, JES uses standard EBCDIC character set arrangement A, with 48 characters, 
to print the sysout data set on a 3211 printer. 
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OUTPUT JCL: WRITER 


WRITER Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the WRITER parameter to name an external writer to process the sysout data 
set rather than JES. An external writer is an IBM- or installation-written program. 


References: For information about external writers, see SPL: System Modifications. 


Syntax: 


WRITER=name 


Subparameter Definition 


Defaults 


Overrides 


name 
Identifies the member name (1 to 8 alphanumeric characters) of an installation-written 
program in the system library that the external writer loads to write the output data set. 


Do not code INTRDR or STDWTR (and for JES3, NJERDR) as the writer name. 
These names are reserved for JES. 


If you do not code the WRITER parameter, the installation’s job entry subsystem processes the 
sysout data set. 


The writer-name subparameter of the SYSOUT parameter on the sysout DD statement 
overrides the OUTPUT JCL WRITER parameter. 


| Relationship to Other Parameters 


For JES3, you can code the OUTPUT JCL DEST =nodename parameter with the 
WRITER = name parameter; however, do not code DEST = nodename.userid with 
WRITER = name. 


Starting an External Writer 


When a statement supplying processing options for a sysout data set specifies an external writer, 
the writer must be started before it can print or punch the data set. The writer is started by a 
system command from the operator or in the input stream. If the writer is not started before 
the job produces the sysout data set, the data set is retained until the writer is started. 
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Example of the WRITER Parameter 


//MYOUT JOB ACCT928 ,MAEBIRD ,MSGCLASS=B 
// START XWTR 

//MYDS OUTPUT WRITER=MYPGM 

//STEP1 EXEC  PGM=REPORT 

//RPT1 ODD SYSOUT=A , OUTPUT=* .MYDS 


In a JES2 system, the second statement is a JCL command statement to start the IBM-supplied 
external writer. This writer is a cataloged procedure in SYS1.PROCLIB. The sysout DD 
statement RPT1 explicitly references OUTPUT JCL statement MYDS, which specifies that the 
program MYPGM is to be loaded by XWTR and process the sysout data set. 


//**START XWTR 

//MYOUT JOB ACCT928 ,MAEBIRD ,MSGCLASS=B 

//MYDS OUTPUT WRITER=MYPGM 

//STEP1 EXEC  PGM=REPORT : 
//RPT1 DD SYSOUT=A , OUTPUT=* .MYDS ) 


This example is for a JES3 system. 
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Chapter 18. PEND Statement 


Purpose: Use the PEND statement to mark the end of an in-stream procedure. 


Syntax: 


//{name] PEND [comments] 


The PEND statement consists of the characters // in columns | and 2 and three fields: 
name, operation (PEND), and comments. 


Do not continue a PEND statement. 


Name Field 
A name is optional on the PEND statement. If used, code it as follows: 


Each name must be unique within the job. 

The name must begin in column 3. 

The name is | through 8 alphanumeric or national ($, #, @) characters. 
The first character must be alphabetic or national ($, #, @). 

The name must be followed by at least one blank. 


If a name is not coded, column 3 must be blank. 


Operation Field 


The operation field consists of the characters PEND and must be preceded and followed by at 
least one blank. It can begin in any column. 


Comments Field 


The comments field follows PEND after at least one intervening blank. 
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PEND 


Location in the JCL 


A PEND statement follows the statements of an in-stream procedure. Never place a PEND - 
Statement in a cataloged procedure. 


Examples of the PEND Statement 


//PROCEND1 PEND THIS STATEMENT IS REQUIRED FOR IN-STREAM PROCEDURES 
This PEND statement contains a comment. 
// PEND 


This PEND statement contains only // and the operation field with the necessary blanks. 
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Chapter 19. PROC Statement 


Purpose: The PROC statement must mark the beginning of an in-stream procedure and, 
optionally, may mark the beginning of a cataloged procedure. For either procedure, the PROC 
statement can assign default values to symbolic parameters, if coded, in the procedure. 


Syntax: 


For a cataloged procedure: 
//{name] PROC [parameter [comments] ] 
//{name] PROC 


For an in-stream procedure: 
//name PROC [parameter [comments] ] 
//name PROC 


A PROC statement consists of the characters // in columns | and 2 and four fields: name, 
operation (PROC), parameter, and comments. 


Multiple Parameters: When more than one parameter is coded, separate parameters by 
commas. For example, //P1 PROC PARMI1=OLD,PARM2= 222001. 


Special Characters: When a parameter value contains special characters, enclose the value in 
apostrophes. The enclosing apostrophes are not considered part of the value. For example, 
//P2 PROC PARM3=’3400-6’. 


Code each apostrophe that is part of a value as two consecutive apostrophes. For example, 
//P3 PROC PARM4=’O”DAY’. 


Continuation onto Another Statement: End each statement with a comma after a complete 
parameter. For example: 


//P4 PROC PARM5=OLD,PARM6='SYS1.LINKLIB(P40)', 
J / PARM7=SYSDA,PARM8='(CYL,(10,1))' 
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Name Field 


A name is required on a PROC statement in an in-stream procedure and is optional on a 
PROC statement in a cataloged procedure. Code it as follows: 


Each name must be unique within the job. 

The name must begin in column 3. 

The name is | through 8 alphanumeric or national ($, #, @) characters. 
The first character must be alphabetic or national ($, #, @). 

The name must be followed by at least one blank. 


If a name is not coded, column 3 must be blank. 


Operation Field 


The operation field consists of the characters PROC and must be preceded and followed by at 
least one blank. It can begin in any column. 


Parameter Field 


The parameters on a PROC statement assign default values to symbolic parameters on 
procedure statements. An in-stream PROC statement requires parameters only if the procedure 
contains symbolic parameters. See “Symbolic Parameters” on page 5-8 for details on symbolic 
parameters and on how to assign values to them. 


If coded, the parameter field must be preceded and followed by at least one blank. 


Comments Field 


The comments field follows the parameter field after at least one intervening blank. Do not 
code comments unless you code the parameter field. 


Overrides 


_ | 
To override a default parameter value on a PROC statement, code the same parameter on the J 
EXEC statement that calls the procedure. 


Location in the JCL 


A PROC statement must begin all in-stream procedures and may begin a cataloged procedure. 
An in-stream procedure must appear in the same job before the EXEC statement that calls it. 
A cataloged procedure appears in a procedure library, usually SYS1.PROCLIB. 
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Examples of the PROC Statement 


/ /DEF PROC STATUS=OLD,LIBRARY=SYSLIB , NUMBER=777777 
//NOTIFY EXEC PGM=ACCUM 

//DD1 DD DSNAME=MGMT , DISP=(&STATUS, KEEP) , UNIT=3400-6, 
df VOLUME=SER=888888 

//DD2 DD DSNAME=&LIBRARY , DISP=(OLD, KEEP) , UNIT=3350, 
// VOLUME=SER=&NUMBER 


Three symbolic parameters are defined in this cataloged procedure: &STATUS, &LIBRARY, 
and &NUMBER. Values are assigned to the symbolic parameters on the PROC statement. 
These values are used when the procedure is called and values are not assigned to the symbolic 
parameters on the calling EXEC statement. 


//CARDS PROC 


This PROC statement can be used to mark the beginning of an in-stream procedure named 
CARDS. 
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Chapter 20. XMIT JCL Statement 


Support for the XMIT JCL Statement: 
e The XMIT JCL statement is supported only on JES3 systems. 


e For JES2, the XMIT JCL statement is not supported. Use the JES2 /*XMIT statement to 
transmit records. 


e For TSO, the XMIT JCL statement is supported only with TSO Extensions Release 3 or 
later. With earlier TSO releases, network jobs submitted through TSO that use the XMIT 
JCL statement are run locally. 


Purpose: Use the XMIT JCL statement to transmit records from an MVS JES3 node to a 
JES3 node, a JES2 node, a VSE/POWER node, or a VM/RSCS node. 


The sending system does not process or check the records for validity except when the JCL 1s 
processed by an internal reader (such as with TSO submit processing). In this case, the system 
recognizes /*“EOF and /*DEL as internal reader control statements and errors can occur on the 
sending system if /*EOF or /*DEL are included in the XMIT JCL stream. 


To transmit /*EOF and /*DEL statements as part of the XMIT JCL stream, replace /* with 
two substitute characters and identify the substitute characters on the SUBCHARS parameter. 
Prior to transmission, the sending system converts the two substitute characters to /*. The 
receiving (execution) system can then process the /*EOF and /*DEL statements as internal 
reader control statements. 


Do not nest XMIT JCL statements. That is, do not include an XMIT JCL statement between 
an XMIT JCL statement and its delimiter. 


The system builds network job header and trailer records from information on the JOB 
statement and any //*NETACCT statements, if included, preceding the XMIT JCL statement. 
Then the system transmits all the records between the XMIT JCL statement and a delimiter 
statement. 


The records can consist of a job input stream, an in-stream DD * or DD DATA data set, or 
any job definition statements recognized by the destination node. If the records are a job input 
stream, and the destination node can process the JCL, the transmitted input stream is executed 
at the destination node. 


The records end when the system finds one of the following delimiters: 


e /* in the input stream, if a DLM parameter is not coded on this XMIT JCL statement. 
(Refer to Chapter 12. Delimiter Statement for an explanation of /*.) 


From TSO only, TSO inserts /* at the end-of-file if the default delimiter is not supplied. 
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@ The two-character delimiter specified by a DLM parameter on this XMIT JCL statement. 
Syntax: 


//{name] XMIT parameter[,parameter]... [comments] 


The XMIT JCL statement consists of the characters // in columns 1 and 2 and four fields: 
name, operation (XMIT), parameter, and comments. 


Name Field 
A name is optional on the XMIT JCL statement. If used, code it as follows: 


Each name must be unique within the job. 

The name must begin in column 3. 

The name is 1 through 8 alphanumeric or national ($, #, @) characters. 
The first character must be alphabetic or national ($, #, @). 

The name must be followed by at least one blank. 


Operation Field 


The operation field consists of the characters XMIT and must be preceded and followed by at 
least one blank. It can begin in any column. 


Parameter Field 


The XMIT JCL statement contains only keyword parameters. A DEST parameter is required; 
the DLM and SUBCHARS parameters are optional. If your JCL is to be processed by an 
internal reader and /*EOF or /*DEL is part of the XMIT JCL stream, you must code the 
SUBCHARS parameter. 


You can code the keyword parameters in any order in the parameter field. 


KEYWORD PARAMETERS VALUES PURPOSE 


DEST = nodename[.vmuserid] nodename: 1 - 8 alphanumeric or $, #, @ Identifies the destination for all 
characters following records until a 
vmuserid: 1 - 8 alphanumeric or §, #, @ delimiter stops transmission 
characters of the records. 
See page 20-5 


DLM = delimiter delimiter: 2 alphanumeric, $, #, @, or Specifies a delimiter to stop the 
special characters transmission of records. 


See page 20-6 


SUBCHARS = substitute substitute: 2 alphanumeric, $, #, @, or Specifies a substitute for internal 
special characters reader contro! statements. 


See page 20-8 
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Comments Field 


The comments field follows the parameter field after at least one intervening blank. 


Location in the JCL 


Place the XMIT JCL statement after a JOB statement and any //*“NETACCT statements. 
(Other JES3 JCL statements between the JOB and XMIT JCL statements are not supported 
and can cause unpredictable results.) The JOB statement must be valid for the submitting 
location. 


Do not place any other MVS JCL statements between the JOB statement and the XMIT JCL 
statement. If any of these statements intervene, the system terminates the job. 


Error on XMIT JCL Statement 


If the system finds an error on the XMIT JCL statement before a specified DLM parameter, all 
jobs in the batch are flushed. 


If the system finds an error on the XMIT JCL statement after a specified DLM parameter, the 
network job is flushed and local processing starts at the statement following the specified 
delimiter. 


Examples of the XMIT JCL Statement 


//JOBA JOB 25FA64,'KEN KAHN' 
//X1 XMIT DEST=KGNMVS45 


(records to be transmitted) 


f*® 
//JOBB JOB 


In this example, the records between the XMIT JCL statement and the delimiter statement (/* 
in columns 1 and 2) are transmitted to the node named KGNMVS45. 


Chapter 20. XMIT JCL Statement 20-3 


XMIT JCL 


//JOBC JOB PW19,'DEPT 53! 


//X2 XMIT DEST=POKVMDD3 .MVSGST34 , DLM=AA 
j* 
(records to be transmitted) 
/ *EOF 
/* DEL 
AA 


//JOBB JOB 


In this example, processing is not through an internal reader on the sending system. The 
records between the XMIT JCL statement and the delimiter statement, which must contain AA 
in columns 1 and 2 as specified in the DLM parameter, are transmitted to the system, 
MVSGST34, running on the VM system at the node named POKVMDD3. 


//JOBE JOB NS37,'NYC BX! 
//¥3 XMIT DEST=SANFRAN,DLM=AA,SUBCHARS='/+' 


(records to be transmitted) 


/+EOF 


/+DEL ) 
AA 


//JOBF JOB 


In this example, the JCL is processed through an internal reader on the sending system. The 
records between the XMIT JCL statement and the delimiter statement, which must contain AA 
in columns 1 and 2 as specified in the DLM parameter, are transmitted to the node named 
SANFRAN. 


To transmit the /*“EOF and /*DEL internal reader control statements, /* is replaced by /+ in - 
columns 1 and 2 on both statements in the XMIT JCL stream and SUBCHARS =’/ +’ is coded 

on the XMIT statement. The sending system does not recognize /+EOF and /+DEL as 

internal reader statements. Then prior to transmission, the sending system converts /+ to /* 

and sends /*EOF and /*DEL to the receiving node, which can then process the internal reader 

control statements. 
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DEST Parameter 


Parameter Type: Keyword, required 
Purpose: Use the DEST parameter to specify a destination for the following input stream 
records. The DEST parameter can send the records to a node or, for a node that is a VM 


system, to a guest system running on the virtual machine. 


Syntax: 


DEST=nodename 


DEST=nodename.vmuserid 


Subparameter Definition 

nodename 
Identifies the destination node. The nodename identifies a JES2 system, a JES3 system, a 
VSE/POWER node, or a VM system. The nodename is | through 8 alphanumeric or 
national ($, #, @) characters specified during JES initialization. If the requested node is 
the same as the submitting node, the records following the XMIT JCL statement are 
processed by the local system. 

vmuserid 


Identifies a destination guest system running in a virtual machine. The vmuserid is 1 
through 8 alphanumeric or national ($, #, @) characters. 


Examples of the DEST Parameter 


//TRANS XMIT DEST=LAXSYS 
This example sends the following records to a node named LAXSYS. 
//SEND XMIT DEST=VMSYS3.GUEST7 


This example sends the following records to a guest system, named GUEST7, running in the 
VM system at the node named VMSYS3. 
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DLM Parameter 


Parameter Type: Keyword, optional 

Purpose: Use the DLM parameter to specify a delimiter to stop transmission of input stream 
records. When the DLM parameter assigns a delimiter other than the standard delimiter (/* in 
columns 1 and 2), the records can include the standard delimiter. 

If you use the DLM delimiter to define a delimiter, be sure to terminate the records with the 
specified DLM characters. Otherwise, all jobs between the XMIT JCL statement and the 
end-of-file are flushed. 

From TSO only, TSO inserts /* at the end-of-file if the default delimiter is not supplied. 
Syntax: 


DLM=delimiter 


If the specified delimiter contains any special characters, enclose the delimiter in 
apostrophes. In this case, a special character is any character that is neither 


alphanumeric nor national ($, #, @). 


If the delimiter contains an ampersand or an apostrophe, code each ampersand or 

apostrophe as two consecutive ampersands or apostrophes and enclose the delimiter in 

apostrophes. Each pair of consecutive ampersands or apostrophes counts as one 2 
character. 


Subparameter Definition 


delimiter 
Specifies two characters that indicate the end of this data set in the input stream. 


Default 


If you do not specify a DLM parameter, the default is the standard /* delimiter statement. 


Invalid Delimiters 


If the delimiter 1s not two characters, the system terminates the job and does not transmit any 
records. 
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Examples of the DLM Parameter 


//XX XMIT DEST=NYCNODE , DLM=AA 


(records to be transmitted) 


AA 


The DLM parameter assigns the characters AA as the delimiter for the in-stream records to be 
transmitted. 


//XXY XMIT DEST=ATL,DLM='A+' 
//%Z XMIT DEST=BOST,DLM='&&7' 
//X4 XMIT DEST=CHI,DLM='B''' 


These examples specify delimiters of A+, &7, and B’. 
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| SUBCHARS Parameter 


Parameter Type: Keyword, optional 


Purpose: Use the SUBCHARS parameter to specify a substitute (consisting of two characters) 
for the first two characters of /*“EOF and /*DEL internal reader control statements. The 
substitute characters on the internal reader control statements must be in columns | and 2. 


You can use the SUBCHARS parameter for any XMIT JCL job. However, SUBCHARS is 
required if you want to transmit internal reader control statements (/*EOF and /*DEL) and the 
job is processed by an internal reader on the sending system. Note that the system recognizes 
/*EOF and /*DEL as internal reader control statements and errors can occur on the sending 
system if /*EOF or /*DEL are included in the XMIT JCL stream. 


| To transmit internal reader control statements, replace /* on the /*EOF and /*DEL statements 
| in the records to be transmitted with two substitute characters and identify the substitute 

| characters on the SUBCHARS parameter. Prior to transmission, the system converts the 

| substitute characters to /* and sends /*EOF and /*DEL to the receiving node for processing. 


| Reference: The internal reader is described in SPL: JES3 Initialization and Tuning and SPL: 
| System Modifications. 


| Syntax: 
| SUBCHARS=substitute 
| If the specified substitute contains any special characters, enclose the substitute in 


| apostrophes. In this case, a special character is any character that is neither 
| alphanumeric nor national ($, #, @). 


If the substitute contains an ampersand or an apostrophe, code each ampersand or 
apostrophe as two consecutive ampersands or apostrophes and enclose the substitute in 
apostrophes. Each pair of consecutive ampersands or apostrophes counts as one 
character. 


| Subparameter Definition 


| substitute 

| Specifies two characters that indicate the substitute characters for the first two characters 
| of internal reader control statements. The substitute characters apply only to internal 

| reader statements. 
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| Default 


| There is no default for SUBCHARS. 


| Invalid Substitute 


| If the substitute is not two characters, the system terminates the job and does not transmit any 
| records. 


Examples of the SUBCHARS Parameter 
//XX XMIT DEST=NYCNODE, SUBCHARS=MV 


| 
| (records to be transmitted) 
| MVEOF 

| 


| The SUBCHARS parameter identifies the characters MV as the substitute for the first two 

| characters of the internal reader control statement to be transmitted. Prior to transmission, the 
| system converts the MV substitute characters to /* and sends /*EOF to the receiving node for 

| processing. 


| //¥X% XMIT DEST=ATL,SUBCHARS='A+' 
| //XZ XMIT DEST=BOST,SUBCHARS='&&7' 
| //X¥W XMIT DEST=CHI,SUBCHARS='B'''! 


| These examples specify substitutes of A+, &7, and B’. 
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Chapter 21. JES2 Control Statements 


Code JES2 control statements with JCL statements to control the input and output processing 
of jobs. The rules for coding in Chapter 3, “Format of Statements” and Chapter 4, “Syntax 
of Parameters” apply to the JES2 control statements. 


Location in the JCL 


Place JES2 control statements, except the command and /*PRIORITY statements, after the 
JOB statement and its continuations. JES2 ignores JES2 control statements, except the 
command and /*PRIORITY statements, that appear before the JOB statement or between 
continued JOB statements. | 


Do not include JES2 control statements in a cataloged or in-stream procedure. JES2 ignores 
JES2 control statements in a procedure. 


Internal Reader 


Use the following control statements when submitting jobs to the internal reader. The internal 
reader is described in SPL: JES2 Initialization and Tuning and SPL: System Modifications. 


/*DEL 
/*EOF 
/*PURGE 
/*SCAN 
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JES2: Command 


JES2 Command Statement 


Purpose: Use the command statement to enter a JES2 operator command through the input 
stream, the internal reader, or the system console. 


JES2 usually executes an in-stream command as soon as it is read. Therefore, the command 
will not be synchronized with the execution of any job or step in the input stream. To 
synchronize a command with the job processing, tell the operator the commands you want and 
when they should be issued, and let the operator enter them from the console. 


Examples in this book illustrate the format for commands entered through the input stream. 
Commands entered through an operator console should not have /* in columns | and 2. 


References: For more information on the command statement and the JES2 verbs and 
operands, see JES2 Commands. 


Syntax: 


/*Scommand-verb,operand[,operand]... 


The JES2 command statement consists of: 


The characters /* in columns | and 2. 

$ or a character chosen by the installation in column 3. 

The command verb beginning in column 4. 

A comma. 

Operands up through column 71. 

N in column 72 if JES2 is not to write the command on the operator console. 
Blanks in columns 73 through 80. JES2 ignores these columns. 


Do not continue command statements from one statement to the next, instead code as many 
command statements as you need. 


Parameter Definition 


command-verb 
Specifies the operator command that JES2 is to perform. You can enter the following 
JES2 commands in the input stream. 


$A $E $I $0 $T 
$B $F $L $P S$TRACE 
$C $G $M $R_ $V 
$D SH $N $S $2 


operand 
Specifies options for the command. 


N in column 72 
Indicates that JES2 is not to repeat the command on the operator console. 
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Location in the JCL 


Place JES2 command statements before jobs being entered through the input stream. JES2 
ignores any JES2 command statements within a job. 


If a job contains a JES2 /*XMIT statement, place the command statement: 


e Before the /*XMIT statement if you want JES2 to process and display the command at the 
input node only. 


e After the /*“XMIT statement if you want JES2 to process and display the command at the 
execution node only. 


Examples of the Command Statement 


/*$SI3-5 

This command statement starts initiators three through five. The command is $S and the 
operand is I3-5. JES2 executes the command immediately and repeats the command on the 
operator console. 

/*$TRDR1,H=Y 

In response to this command, JES2 places all jobs being read by reader 1 in a hold status. Ifa 


job contains a JES2 /*ROUTE XEQ or /*XEQ statement that specifies an execution node 
different from the input node, JES2 holds the job at the execution node, not the input node. 


Chapter 21. JES2 Control Statements 21-3 


JES2: /*JOBPARM 


/*JOBPARM Statement 


Purpose: Use the /*JOBPARM statement to specify job-related parameters for JES2. 


Syntax: 


/*JOBPARM parameter[,parameter]... 
The parameters are: 


BURST |=|Y 
B N 


BYTES |=nnnnnn 
CARDS |=nnnnnnn 


COPIES |=nnn cs ) 
N 


fe 
ls 
| 
from} =| excexcex| 

furwece} «nnn 

fnves| nan 

fyouos J 
[paces] nana 

E 

| 

B 

: 


naile =ddname 


RESTART 
E 


ROOM | =xxxx J 


— 


(ANY[,IND] ) 

cece 

(cccc[,IND] ) 
(cccc[,cecc]...) 
((cccec[,cccc]...)[,IND] ) 


eo =nnnn 
a 
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The /*JOBPARM statement consists of the characters /* in columns 1 and 2, JOBPARM in 
columns 3 through 9, a blank in column 10, and parameters in columns 11 through 71. JES2 
ignores columns 72 through 80. 


Do not continue a /*tJOBPARM statement. Instead, code as many /*JOBPARM statements 
as necessary in an input stream. 


Code any number of the above parameters on a single /*JOBPARM statement. 


Parameter Definition 


BURST =Y 

BURST =N 
Specifies the default burst characteristic of all sysout data sets that JES2 produces for this 
job. BURST applies only when the data set is directed to a 3800 Printing Subsystem 
equipped with a burster-trimmer-stacker. 


y 
Requests that the 3800 output is to be burst into separate sheets. 


N 
Requests that the 3800 output is to be in a continuous fanfold. 


BYTES = nonnnn 
Specifies the maximum output, in thousands of bytes, the system is to produce from this 
job. The nnnnnn is | through 6 decimal numbers from 0 through 999999. When nnnnnn 
bytes are reached, JES2 gives control to a user exit routine and the job might or might 
not be terminated. 


CARDS = nnnonnn 
Specifies the maximum number of output cards to be punched for this job’s sysout data 
sets. The nnnnnnn is | through 7 decimal numbers from 0 through 9999999. When 
nnnnnnn cards are reached, JES2 gives control to a user exit routine and the job might or 
might not be terminated. 


COPIES = non 
Specifies how many copies of the spool lines or bytes for this job’s sysout data sets are to 
be printed or punched. The nnn is | through 3 decimal numbers from 1 through 255. An 
installation can reduce the upper limit of this value during JES2 initialization. 


The COPIES parameter is ignored and only one copy is produced if any of the following 
is true: 


e FREE=CLOSE is coded on the DD statement for the output data set. 
e HOLD= YES its coded on any sysout DD statement in the job. 
e The output class of the sysout data set is a held class, and the message class is also a 


held class. The message class is specified in the JOB statement MSGCLASS 
parameter. 
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FORMS = xxxxxxxx 


FORMS =STD ' 
Specifies the print and/or punch forms JES2 is to use for sysout data sets for which J 
FORMS is not specified on the DD statement or on a JES2 /*OUTPUT statement. 


XXXXXXXX 
Identifies the print or punch forms. The xxxxxxxx is | through 8 alphanumeric or 
national ($, #, @) characters. 


STD 
Indicates that JES2 is to use the default specified at JES2 initialization. 


LINECT = nnn 
Specifies the maximum number of lines that JES2 is to print on each output page for this 
job’s sysout data sets. The nnn is 1 through 3 numbers from 0 through 255. 


If you code LINECT =0, JES2 does not eject to a new page when the number of output | 
lines exceeds the page limit that the installation specified during JES2 initialization. ) 


The LINECT parameter on the /*“OUTPUT statement overrides LINECT on the 
/*JOBPARM statement and the linect value in the accounting information parameter of 
the JOB statement. : 


LINES = nnnn 
Specifies the maximum output, in thousands of lines, that JES2 is to place in the spool 
data sets for this job’s sysout data sets. The nnnn is | through 4 decimal numbers from 0 
through 9999. When nnnn lines are reached, JES2 gives control to a user exit routine and 
the job might or might not be terminated. S) 


The LINES parameter applies only to line-mode data. (See also the PAGES parameter.) 
If the sysout data set contains both line-mode and page-mode data, the lines and pages 
are counted separately and each checked for limit excession. 


NOLOG 
Requests that JES2 not print the job’s hard-copy log. The job’s hard-copy log contains 
the JES2 and operator messages about the job’s processing: allocation of devices and 
volumes, execution and termination of job steps and the job, and disposition of data sets. ) 


PAGES = nnnnn 
Specifies the maximum number of output pages to be printed for this job’s sysout data 
sets. The nnnnn is | through 5 decimal numbers from 0 through 99999. When nnnnn 
pages are reached, JES2 gives control to a user exit routine and the job might or might 
not be terminated. 


The PAGES parameter applies only to page-mode data. (See also the LINES parameter.) 
If the sysout data set contains both page-mode and line-mode data, the pages and lines 
are counted separately and each checked for limit excession. 


PROCLIB = ddname 
Requests a JES2 procedure library by its ddname in the system procedure library, 
SYS!1.PROCLIB. These JES2 procedure library ddnames are in the format PROCnn, 
where nn is 1 or 2 decimal numbers from | through 99. The system retrieves called 
cataloged procedures from the requested JES2 procedure library. If the PROCLIB 
parameter is omitted, or the ddname cannot be found in SYS!1.PROCLIB, the procedure 
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library specified by the JOBCLASS initialization parameter is used. If none is found, the 
default, PROCOO 1s used. 


RESTART =Y 

RESTART =N 
Requests one of the following, if this job is executing before a re-I[PL and JES2 warm 
start, and the job cannot restart from a step or checkpoint. 


Y 
Requests that JES2 queue the job for re-execution from the beginning of the job. 


N 
Requests that JES2 take no special action. 


Note: If you do not specify RESTART, JES2 assumes N. However, the installation may 
override this default in JES2 initialization parameters. 


ROOM = xxxx 
Indicates the programmer’s room number. The xxxx is 1 through 4 alphanumeric 
characters. JES2 places the room number on the job’s separators so that the installation 
can deliver the job’s sysout data sets to the programmer. 


SYSAFF =* 

SYSAFF = (*[,IND]) 

SYSAFF = ANY 

SYSAFF = (ANY],IND]) 

SYSAFF = cece 

SYSAFF = (ccce[,IND]) 

SYSAFF = (ccce[,cccc]...) 

SYSAFF = ((cccc[,cccc]...)[,IND]) 
Indicates the systems that are eligible to process the job. The parameter indicates from 1 
through 7 system affinities. 


Note: For TSO-submitted jobs that specify NOTIFY in the JOB statement: after a job 
has completed execution, JES2 may change the SYSAFF specification for the job if the 
job executed on a processor other than the processor that the user is logged on. This is 
done by JES2 during output processing to allow NOTIFY processing to take place on the 
user’s processor. 


* 


Indicates the system that read the job. 


ANY 
Indicates any system in the JES2 multi-access spool configuration. 


cece 
Indicates a specific system. cccc must be the 4-alphanumeric-character system id of 
one of the systems in the JES2 multi-access spool configuration. To specify more 
than one system, separate the system ids with commas and enclose the system id list 
in parentheses; for example, SYSAFF =(cccc,cccc,cccc). Repeat cccc up to the 
number of processors in the configuration. 
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IND 
After any of the other SYSAFF specifications, indicates that JES2 is to use system ) 
scheduling in independent mode. When IND is coded, the subparameters must be 
enclosed in parentheses. 


TIME = nnon 
Estimates the job execution time, in minutes of real time. The nnnn is | through 4 
decimal numbers from 0 through 9999. If you omit a TIME parameter and a time 
subparameter in the JOB statement accounting information parameter, JES2 uses an 
installation default specified at initialization. If job execution exceeds the time, JES2 
sends a message to the operator. 


Overrides 
e The /*JOBPARM statement parameters override the installation defaults specified at JES2 
initialization. 
e An OUTPUT JCL statement can override parameters on a /*JOBPARM statement. J 
e A JES2 /*OUTPUT statement can override parameters on a /*JOBPARM statement. 
e Any /*JOBPARM statement parameter value overrides the equivalent parameter value 
from the JES2 accounting information on the JOB statement or from any preceding 
/*JOBPARM statement in this job. 
Location in the JCL ) 


Place the /*JOBPARM statement after the JOB statement. 


Execution Node 
JES2 normally processes /*JOBPARM statements at the node of execution. 


When you place a /*JOBPARM statement before a /*“ROUTE XEQ or /*XEQ statement, JES2 

at the input node checks the /*JOBPARM statement for syntax and parameter validity. After J 
processing the /*“ROUTE XEQ or /*XEQ statement, JES2 then passes the /*JOBPARM 

statement to the execution node, where syntax and parameter validity are again checked. 


When you place a /*JOBPARM statement after a /*ROUTE XEQ or /*XEQ statement, JES2 
passes the /*JOBPARM to the execution node and performs all syntax and parameter validity 
processing at the execution node only. 


COPIES Parameter in Remote Processing: In remote processing, the COPIES parameter on 
the /*JOBPARM statement determines the number of output copies only when the execution 
node is a JES2 node. The /*JOBPARM COPIES parameter is not supported by RSCS, 
DOS/VSE POWER, or JES3. 
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Example of the /*JOBPARM Statement 


iS 


/* JOBPARM LINES=60, ROOM=4222 ,TIME=50,PROCLIB=PROCO3 ,COPIES=5 
/*JOBPARM L=60,R=4222,T=50,P=PROCO3,N=5 


The two statements specify the same parameters and values. The parameter specifications mean 
the following: 


LINES = 60 or L=60 
The job’s estimated output will be 60,000 lines. 


ROOM = 4222 or R= 4222 
The programmer’s room is 4222. JES2 places this information in the separators for both 
printed and punched data sets. 
TIME =50 or T =50 
c The job’s estimated execution time is 50 minutes. 


PROCLIB = PROC03 or P= PROCO03 
The procedure library that JES2 is to use to convert the JCL for this job is PROCO3. 


COPIES =5 or N=5 
The estimated 60,000 lines of output will be printed five times. 


Chapter 21. JES2 Control Statements 21-9 


JES2: /*MESSAGE 


/*MESSAGE Statement 


Purpose: Use the /*“MESSAGE statement to send messages to the operator console when JES2 
reads in the job. 


Syntax: 


/*MESSAGE message 


The /*“MESSAGE statement consists of the characters /* in columns 1 and 2, MESSAGE in 
columns 3 through 9, a blank in column 10, and the message starting in any column from 11 
through 71. JES2 ignores columns 72 through 80. 


Relationship to the /*“ROUTE XEQ Statement 
If the /*“MESSAGE statement is in a job that also contains a JES2 /*“ROUTE XEQ statement: 


e Placing the /*“MESSAGE statement before the /*“ROUTE XEQ statement directs JES2 to 
send the message to the operators at the input node and the execution node. 


e Placing the /*“MESSAGE statement after the /*“ROUTE XEQ statement directs JES2 to 
send the message only to the operator at the execution node. 


Location in the JCL 


If the /“MESSAGE statement is after the JOB statement, JES2 appends the job number to the 
beginning of the message. 


If the /*“*MESSAGE statement is not within a job, JES2 appends the input device name to the 
beginning of the message. 


Example of the /* MESSAGE Statement 


/*MESSAGE CALL DEPT 58 WHEN PAYROLL JOB IS FINISHED--EX.1946 


JES2 sends this message to the operator console when the job is read in. 
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[*NETACCT Statement 


Purpose: Use the /“NETACCT statement to specify an account number that is available to all 
the nodes in a network. JES2 uses the account number as is or translates it to local account 
numbers. 


Syntax: 


/*NETACCT network~-account-number 


The /*NETACCT statement consists of the characters /* in columns | and 2, NETACCT in 
columns 3 through 9, a blank in column 10, and the network account number starting in any 
column from 11 through 71. JES2 ignores columns 72 through 80. 


Parameter Definition 
network-account-number 


Specifies the job’s accounting number. The network-account-number is | through 8 
alphanumeric characters. 


Defaults 


If no /*“NETACCT statement is specified, JES2 uses the local account number to search a table 
for the network account number. 


Overrides 


If you supply both a /*NETACCT and a local account number, JES2 uses the local account 
number on the input node. 


Location in the JCL 
Place the /*“NETACCT statement after the JOB statement. 


If a job contains more than one /*NETACCT statement, JES2 uses the network account 
number from the last statement. 


JES2 ignores the /*NETACCT statement on any node other than the input node. 


Example of the /*NETACCT Statement 


/*NETACCT NETNUM10 


JES2 transmits the network account number, NETNUM10, with the job to the destination 
node. 
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/*NOTIFY Statement 2 


Purpose: Use the /*“NOTIFY statement to direct a job’s notification messages to a user. 


Note: The /*NOTIFY statement does not affect where the job is executed or where output is 
printed or punched. 


Syntax: 


nodename.userid 
nodename:userid 

/ *NOTIFY nodename/userid 
nodename (userid) 
userid 


The /*NOTIFY statement consists of the characters /* in columns 1 and 2, NOTIFY in ) 
columns 3 through 8, a blank in column 10, and a parameter starting in any column from 11 
through 71. JES2 ignores columns 72 through 80. 


Do not code a comma, a right parenthesis, or a blank character in the nodename or userid. 


Parameter Definition 


nodename.userid S) 
nodename:userid 
nodename/userid 
nodename(userid) 
Identifies a node and a TSO or VM userid at that node. The nodename is a symbolic 
name defined by the installation during initialization; nodename is | through 8 
alphanumeric or national ($, #, @) characters. The userid must be defined at the node; 
userid for TSO is 1 through 7 alphanumeric or national ($, #, @) characters and for VM 
is 1 through 8 alphanumeric or national ($, #, @) characters. 


When you specify a nodename and userid, JES2 sets the origin node field in the job’s } 
network job header to the specified node, even though the job origin node may be 
different. 


userid 
Identifies a TSO or VM user. The userid for TSO is 1 through 7 alphanumeric or 
national ($, #, @) characters and for VM is 1 through 8 alphanumeric or national (3, #, 
@) characters. When you specify only a userid, JES2 assumes that the userid is at the 
origin node. 
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Overrides 


The JES2 /*NOTIFY statement overrides the NOTIFY parameter on the JOB statement. 


Relationship to Other Control Statements 
If you submit a TSO job with a JOB statement NOTIFY parameter or the job includes a JES2 
/*NOTIFY statement, do not specify IND in a JES2 /*JOBPARM SYSAFF parameter; the 


IND subparameter would change the mode of the job. This change would be invalid because 
the mode of the job must match the mode of the system at which the job is submitted. 


Location in the JCL 


The /*NOTIFY statement directs the notification messages of the job in which it appears; 
place the /*NOTIFY statement after the JOB statement and before the first EXEC statement. 


Examples of the NOTIFY Statement 


/*NOTIFY VMNODE.VMUSER 


JES2 sends notification messages to user VMUSER on node VMNODE. 


/*NOTIFY TSOUSER 


JES2 sends notification messages to user TSOUSER on the job’s origin node. 
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/*OUTPUT Statement 


Purpose: Use the /*OUTPUT statement to specify characteristics and options for one or more 
sysout data sets. This statement supplies processing options in addition to and in place of the 
options specified on the sysout DD statement. 


Note: You should use the OUTPUT JCL statement instead of the JES2 /“OUTPUT statement 
because of the OUTPUT JCL statement’s enhanced output processing capabilities. 


Syntax: 


/*OUTPUT code parameter[,parameter]... 


The parameters are: 


i, 


=|xxxx J 


(xxxx[,xxxx]...) 


CKPTLNS | =nnnnn 
CKPTPGS |=nnnnn 


OMPACT |=nn 


ex tasianatudl eaceented atte 


=|] group-value 
(group-value[,group-value]...) 


DEST|=]destination destination is: 
D (destination[,destination]...) 


LOCAL 
name 
Nnnnn J 
NnnRmmmm 
LASH|=|overlay-name NnnnRmmm 
(overlay-name[,count] ) NnnnnRmm 
NONE nodename.userid 
nodename:userid 
FLASHC|]=count nodename/userid 
Q | nodename (userid) 
Rnnnn 
FORMS |=] xxxx RMnnnn 
F STD RMTnnnn 
Unnnn 
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INDEX | =nn 


=nn 


module-name 
(module-name[,trc] ) 


UCS | =xxxx 
T 


The /“OUTPUT statement consists of the characters /* in columns 1 and 2, OUTPUT in 
columns 3 through 8, a blank in column 9, a code beginning in column 10, followed by a 
blank and the keyword parameters. JES2 ignores columns 72 through 80. 


An * in column 10 indicates that this /*OUTPUT statement is a continuation of the previous 
/*OUTPUT statement: JES2 treats it as a continuation, even through the previous 
/*OUTPUT statement does not immediately precede the continuation. 


Do not specify * in column 10 on the first /“OUTPUT statement in a job. 


Parameter Definition 


code 


Identifies the /*“OUTPUT statement. The code is 1 through 4 alphanumeric characters. 
To refer to a /*OUTPUT statement, the DD statement SYSOUT parameter must specify 
this code in its code-name subparameter. The referenced /*“OUTPUT statement specifies 
processing options for the sysout data set defined in the referencing DD statement. 


A code of * indicates that this /“OUTPUT statement is a continuation of the previous 
/*OUTPUT statement. 


Note: If you specify the code-name subparameter on a DD statement SYSOUT 
parameter in a job or job step that contains a default OUTPUT JCL statement, JES2 uses 
the default OUTPUT JCL statement instead of the reference to the /*OUTPUT 
statement. 


If more than one /*OUTPUT statement has the same code starting in column 10, JES2 
uses the parameters from only the first /*OUTPUT statement. 
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BURST =Y 


BURST =N Jo 
Indicates the default burst characteristic of all sysout data sets that JES2 produces for this 
job. BURST applies only when the data set is directed to a 3800 Printing Subsystem 
equipped with a burster-trimmer-stacker. 


Yy 
Requests that the 3800 output is to be burst into separate sheets. 
N 
Requests that the 3800 output is to be in a continuous fanfold. 
CHARS = xxxx 


CHARS = (xxxx[,xxxx]...) 
Names a character-arrangement table for all output that JES2 prints on a 3800 Printing 
Subsystem in this job. The xxxx is | through 4 alphanumeric or national ($, #, @) 
characters. Code one to four names. 


CKPTLNS =nnnnn J 
Specifies the maximum number of lines or cards contained in a logical page. The nnnnn is 
1 through 5 decimal numbers from 0 through 32767 for printers and 1 through 32767 for 
punches. The default is specified in the JES2 initialization parameter for the device. 


CKPTPGS = nnnon 
Specifies the number of logical pages to be printed before the next checkpoint is taken. 
The nnnnn is | through 5 decimal numbers from | through 32767. The default is 
specified in the JES2 initialization parameter for the device. J 


COMPACT =nn 
Specifies a compaction table for JES2 to use when sending this sysout data set, which 
must be a systems network architecture (SNA) data set, to a SNA remote terminal. 


Note: The COMPACT parameter has no effect on compaction for NJE sessions; it 
applies only to SNA RJE sessions. 


COPIES = nnn | 
COPIES = (nnn|,(group-value|,group-value]...)}) J 
Specifies how many copies of the sysout data set are to be printed in page sequence order, ; 
or from a 3800 Printing Subsystem, grouped by page. 


If you route a job that has a COPIES parameter, the parameter will be used only if the 
receiving node is a JES2 node. 


nnn 
Specifies how many copies of the sysout data set are to be printed; each copy will 
be in page sequence order. The nnn is | through 3 decimal numbers from | through 
255, subject to an installation-specified limit. For a data set printed on a 3800, 
JES2 ignores nnn if any group values are specified. 


If you omit or incorrectly code the nnn parameter of COPIES, it defaults to 1 anda 
warning message is issued. 
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group-value 
Specifies how many copies of each page are to be printed before the next page is 
printed. Each group-value is 1 through 3 decimal numbers from | through 255. 
You can code a maximum of eight group-values. Their sum must not exceed 255 or 
the installation-specified limit. The total copies of each page equals the sum of the 
group-values. 


Note: 


e This subparameter is valid only for 3800 output. 
e For 3800 output, this subparameter overrides the nnn subparameter. 


The following are not valid: 


e A null group-value, for example, COPIES =(S(,)) or COPIES =(5,) 
e <A zero group-value, for example, COPIES =(5,(1,0,4)) 
e A null within a list of group-values, for example, COPIES = (5,(1,,4)) 


COPYG = group-value 

COPYG = (group-value[,group-value]...) 
Specifies how many copies of each page are to be printed before the next page is printed. 
Each group-value is 1 through 3 decimal numbers from | through 255. You can code a 
maximum of eight group-values. Their sum must not exceed 255. The total copies of 
each page equals the sum of the group-values. 


Note: This parameter is valid only for 3800 output. If you code COPYG and JES2 
prints the data set on an impact printer, JES2 ignores COPYG. 


DEST = destination 

DEST = (destination|,destination]...) 
Specifies one to four different destinations for the sysout data set. The destination 
subparameters follow: 


LOCAL 
Indicates any local device. 


name 
Identifies a local or remote device by a symbolic name defined by the installation 
during JES2 initialization. The name is | through 8 alphanumeric or national ($, #, 
@) characters. 


Nnnnn 


Identifies a node. nnnn is | through 4 decimal numbers from 1 through 1000. For 
example, N0103. 
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NonRmmmm 

NonnRmmm 

NononRmm 
Identifies a node and a remote work station connected to the node. The node 
number, indicated in the format by n, is 1 through 4 decimal numbers from 1 
through 1000. The remote work station number, indicated in the format by m, is 1 
through 4 decimal numbers from 1 through 9999. Do not code leading zeros in n or 
m. The maximum number of digits for n and m combined cannot exceed six. Note 
that RO is equivalent to LOCAL specified at node Nn. 


nodename.userid 

nodename:userid 

nodename/userid 

nodename(userid) 
Identifies a destination node and a TSO or VM userid at that node. Use this 
parameter to route a sysout data set between JES2 nodes and non-JES2 nodes. The 
nodename is a symbolic name defined by the installation during initialization; 
nodename is | through 8 alphanumeric or national ($, #, @) characters. The userid 
must be defined at the node; userid for TSO is 1 through 7 alphanumeric or 
national ($, #, @) characters and for VM is | through 8 alphanumeric or national 
($, #, @) characters. 


Use the form nodename.userid to specify up to four destinations using continuation 

statements. The continuation statement must contain the characters /* in columns 1 

and 2, OUTPUT in columns 3 through 8, a blank in column 9, an * in or following 

column 10, followed by one or more blanks, and the characters DEST = with the 

specified destinations. For example: J 


/*OUTPUT ABCD DEST=(POK.USER27,NYC.USER31) 
/*OUTPUT * DEST=(BOCA.USER58,STL.USER22) 


Use the form nodename:userid to submit a job to an MVS system from a VM userid 
and to receive the output in the VM user’s virtual reader. 


Use the form nodename.userid to send the output to the local VM printer. 


If you specify a TSO userid, do not specify a nodename that is the same as the 
origin node. J 
Note: Ifa data set is queued for transmission and an operator changes its 

destination, the userid portion of the original routing is lost. 


Rnnnn 

RMnnann 

RMTnnnn 
Identifies a remote terminal. nnnn is 1 through 4 decimal numbers from | through 
9999. With remote pooling, the installation may translate this route code to another 
route code. Note that RO is equivalent to LOCAL. 


Unnnn 
Identifies a local terminal with special routing. nnnn is 1 through 4 decimal 
numbers from 1 through 9999. 
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FCB = xxxx 
Identifies the forms control buffer (FCB) image JES2 is to use to guide printing of the 
sysout data set. The xxxx is 1 through 4 alphanumeric or national ($, #, @) characters 
and is the last characters of a SYS1.I[MAGELIB member name: 


@ FCB2xxxx member, for a 3211 Printer, a 3203 Printer Model 5, or a printer 
supported by systems network architecture (SNA). 


@ FCB3xxxx member, for a 3800 Printing Subsystem. 
@ FCB4xxxx member, for a 4248 Printer. 
IBM provides two standard FCB images. Code STD1 or STD2 only to request them. 


e STD1, which specifies 6 lines per inch on an 8.5-inch-long form. (3211 and 3203-5 
only) 

e STD2, which specifies 6 lines per inch on an 11-inch-long form. (3211 and 3203-5 
only) 


If the printer on which JES2 is to print the data set does not have the forms control 
buffer feature, JES2 sends the operator a message to mount the proper carriage control 
tape. 


FLASH = overlay-name 

FLASH = (overlay-name[,count]) 

FLASH = NONE 
Identifies the forms overlay to be used in printing the sysout data set on a 3800 Printing 
Subsystem and, optionally, specifies the number of copies on which the forms overlay is 
to be printed. 


overlay-name 
Identifies the forms overlay frame that the operator is to insert into the printer 
before printing begins. The name is | through 4 alphanumeric or national ($, #, @) 
characters. 


Do not omit the overlay-name. The count subparameter is optional. If you omit it, 
you can omit the parentheses. However, if you omit it, you must not code it as a 
null; for example, FLASH =(ABCD,) is invalid. 


Before printing starts, JES2 does not verify that the operator inserted the correct 
forms overlay frame for flashing. 


count 
Specifies the number, 1 through 255, of copies that JES2 is to flash with the overlay, 
beginning with the first copy printed. 


JES2 determines the maximum number of copies to flash with the forms overlay by 
the value of nnn or the group-value total on the COPIES parameter. If the FLASH 
count value is greater than the value from the COPIES parameter, JES2 prints with 
the forms overlay the lower value. 


The count subparameter of the FLASH parameter overrides the count value of the 
FLASHC parameter. 
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NONE 
Suppresses flashing for this sysout data set. 


Defaults: If you omit this parameter and did not specify FLASH on the DD statement or 
FLASHC on the /*OUTPUT statement, JES2 uses the default specified at JES2 
Initialization. 


If you specify an overlay-name without specifying a count, JES2 flashes all copies. That 
is, the default for count is 255. If you specify 0 for count, JES2 also flashes all copies. 


FLASHC = count 
Specifies the number, 0 through 255, of copies that JES2 is to flash with the overlay, 
beginning with the first copy printed. 


Note: For the 3800 printer, if you specify FLASH and omit FLASHC, JES2 flashes all 
copies. 


The count subparameter of the FLASH parameter overrides the count value of the J 
FLASHC parameter. 


FORMS = xxxx 
FORMS =STD 
Identifies the forms on which JES2 is to print or punch the sysout data set. 


XXXX 
Identifies the print or punch forms. form-name is 1 through 4 alphanumeric or 


national ($, #, @) characters. } 


STD 
Indicates that JES2 is to use the default specified at JES2 initialization. 


INDEX =nn 
Sets the left margin for output on a 3211 Printer with the indexing feature. The width of 
the print line is reduced by the INDEX parameter value. The nn specifies how many 
print positions the left margin on the 3211 output is to be indented. nn is a decimal 
number from | through 31. n=1 indicates flush-left; n=2 through n=31 indent the , 
print line by n-1 positions. J 


JES2 ignores the INDEX parameter if the printer is not a 3211 with the indexing feature. 


INDEX and LINDEX are mutually exclusive; if you code both, JES2 uses the last one 
encountered. 


LINDEX=nn 
Sets the right margin for output on a 3211 Printer with the indexing feature. The width 
of the print line is reduced by the LINDEX parameter value. The nn specifies how many 
print positions the right margin on 3211 output is to be moved in from the full page 
width. nn is a decimal number from 1 through 31. n=1 indicates flush-right; n=2 
through n=31 move the right margin over by n-1 positions. 


JES2 ignores the LINDEX parameter on all printers except the 3211 with the indexing 
feature. 


INDEX and LINDEX are mutually exclusive; if you code both, JES2 uses the last one 
encountered. 
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LINECT =nnn 
Specifies the maximum number of lines JES2 is to print on each output page. The nnn is 
a number from 0 through 255. 


Specify LINECT =0 to keep JES2 from starting a new page when the number of lines 
exceeds the JES2 initialization parameter. 


If you code LINECT on the /*“OUTPUT statement, it overrides the LINECT value on the 
/*JOBPARM statement and the linect value in the accounting information parameter of 
the JOB statement. 


If the LINECT parameter is omitted from the /*OUTPUT statement, JES2 obtains the 
value from one of the following sources, in order: 


1. The LINECT parameter on the /*JOBPARM statement. 
2. The linect field of the accounting information parameter on the JOB statement. 
3. The installation default specified at JES2 initialization. 


MODIFY = module-name 

MODIFY = (module-name[,tre]) 
Specifies a copy-modification module that tells JES2 how to print the sysout data set on a 
3800 Printing Subsystem. The module can specify legends, column headings, blanks, and 
where and on which copies the data is to be printed. The module is defined and stored in 
SYS1.IMAGELIB using the IEBIMAGE utility program. 


module-name 
Identifies a copy-modification module in SYS1.IMAGELIB. The module-name is 1 
through 4 alphanumeric or national ($, #, @) characters. 


Do not omit the module-name. 


tre 
Identifies which table-name in the CHARS parameter is to be used. This table 
reference character is 0 for the first table-name specified, 1 for the second, 2 for the 
third, or 3 for the fourth. 


If you do not specify tre, the default is 0. If the trc value is greater than the number 
of table-names in the CHARS parameter, JES2 uses the first table named in the 
CHARS parameter. 


The trc subparameter is optional. If you omit it, you can omit the parentheses. 
However, if you omit it, you must not code it as a null; for example, 
MODIFY =(TABI1,) is invalid. If you omit the trc subparameter, JES2 uses the 
first table-name. 


The trc subparameter of the MODIFY parameter overrides the trc subparameter of 
the MODTRC parameter. 


MODTRC = tre 
Identifies which table-name in the CHARS parameter is to be used. This table reference 
character is 0 for the first table-name specified, 1 for the second, 2 for the third, or 3 for 
the fourth. 
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If you do not specify tre, the default is 0. If the trc value is greater than the number of 
table-names in the CHARS parameter, JES2 uses the first table named in the CHARS 
parameter. 


The tre subparameter of the MODIFY parameter overrides the trc subparameter of the 
MODTRC parameter. 


UCS = xxxx 


Overrides 


Identifies the universal character set (UCS) image JES2 is to use in printing the sysout 
data set. The xxxx is 1 through 4 alphanumeric or national ($, #, @) characters. See 
Figure 10-2 on page 10-171 for IBM standard special character set codes. 


/*OUTPUT statement parameters override all equivalent DD statement parameters. 


If a /*“OUTPUT statement contains duplicate parameters, the last parameter overrides all 
preceding duplicates, except for the DEST parameter. 


Any parameter coded on subsequent /*OUTPUT statements overrides the same parameter 
on previous /*“OUTPUT statements. 


JES2 adds any parameter you code on subsequent /“OUTPUT statements that you did not 
code on previous /*OUTPUT statements to the previous /“OUTPUT statement. 


If you code LINECT on the /*OUTPUT statement, it overrides the LINECT value on the 
/*JOBPARM statement and the linect value in the accounting information parameter of the 
JOB statement. 


Relationship to Other Control Statements 


JES2 processes /“OUTPUT statements placed after a /*“ROUTE XEQ statement at the 
execution node only. 


JES2 processes /*OUTPUT statements placed before a /*“ROUTE XEQ statement at both 
the input node and the execution node. 


Location in the JCL 


Place the /*“OUTPUT statement after the JOB statement and before the first EXEC statement. 


Example of the /*OUTPUT Statement 


/*OUTPUT ABCD COPIES=6,COPYG=(1,2,3) ,DEST=RMT23 


This statement refers to all sysout data sets defined by a DD statement that specifies 
SYSOUT=(c,,ABCD). Six copies of each page of output are printed. If the printer is a 3800, 
first one copy of each page is printed, then two copies of each page, and finally, three copies of 
each page. If the printer is not a 3800, COPYG is ignored and six copies of the entire data set 
are printed. The output is sent to remote terminal 23. 
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/*PRIORITY Statement 


Purpose: Use the /*PRIORITY statement to assign a selection priority for your job and all of 
its output, except the JES2 hard-copy log. Within a job class, a job with a higher priority is 
selected for execution sooner. 


Note: Depending on the JES2 initialization options in use at your installation, JES2 may 
ignore the /*PRIORITY statement. 


Syntax: 


/*PRIORITY p 


The /*“PRIORITY statement consists of the characters /* in columns | and 2, PRIORITY in 
columns 3 through 10, a blank in column 10, and the priority starting in any column from 11 
through 71. JES2 ignores columns 72 through 80. 


Parameter Definition 


Pp 
Requests a priority. The pis 1 or 2 decimal numbers from 0 through 15. The highest 
priority is 15. 


Follow your installation’s rules in coding a priority. 


Overrides 


A priority specified on a /*PRIORITY statement overrides a priority specified in the PRTY 
parameter on a JOB statement. 


Relationship to Other Control Statements 
The system derives the priority from the following, in override order: 


JES2 /*PRIORITY statement. 

The PRTY parameter on the JOB statement. 

The accounting information on a /*JOBPARM statement. 
The accounting information on the JOB statement. 

An installation default specified at JES2 initialization. 


et a Wee 
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Location in the JCL 


The /*PRIORITY statement must immediately precede the JOB statement. If not, or if p is not 
a number from 0 through 15, JES2 ignores the /*PRIORITY statement and flushes the input 
stream until the next JOB statement or another /*PRIORITY statement. 


In a JES2 network, the /*PRIORITY statement must immediately follow the /*XMIT 
statement and precede a JOB statement. If the /*PRIORITY statement does not immediately 


follow an /*XMIT statement, JES2 ignores the /*“PRIORITY statement at any node except the 
input node. 


Example of the PRIORITY Statement 


/*PRIORITY 7 


This statement assigns a job queue selection priority of 7. This value has meaning only in S 
relation to other jobs in the system. 
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/*ROUTE Statement 


Purpose: Use the /*ROUTE statement to specify the destination of sysout data sets that are 
not routed by a DEST parameter or to identify the network node where the job is to execute. 


Syntax: 


LOCAL 

name 

Nnnnn 

NnnRmmmm 

NnnnRmmm 

NnnnnRmm 

nodename.userid 

PRINT nodename:userid 

/*ROUTE |PUNCH nodename/userid 

nodename (userid) 

Rnnnn 

RMnnnn 

RMTnnnn 

Unnnn 


Nnnnn 
nodename.vmguestid 
nodename: vmguestid 
/*ROUTE XEQ |nodename/vmguestid 
nodename(vmguestid) 


The /*ROUTE statement consists of the characters /* in columns | and 2; ROUTE in 
columns 3 through 7; at least one blank followed by PRINT, PUNCH, or XEQ; at least one 
blank followed by one of the destinations or nodes; and at least one blank before column 72. 
JES2 ignores columns 72 through 80. 


Code only one destination or node on each /*ROUTE statement. 


Parameter Definition 


PRINT 
Requests that JES2 route the job’s sysout data sets that are printed. 


PUNCH 
Requests that JES2 route the job’s sysout data sets that are punched. 


XEQ 


Requests that JES2 route the job to a network node for execution. 
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LOCAL 
Indicates any local device at the node at which the job is submitted. 


name 
Identifies a local or remote device by a symbolic name defined by the installation during 
JES2 initialization. The name is | through 8 alphanumeric or national ($, #, @) 
characters. 


Nnnnn 
Identifies a node. nnnn is 1 through 4 decimal numbers from 1 through 1000. For 
example, NO103. 


NonRmmmm 

NonnRmmm 

NonnaRmm 
Identifies a node and a remote work station connected to the node. The node number, 
indicated in the format by n, is | through 4 decimal numbers from | through 1000. The . 
remote work station number, indicated in the format by m, is | through 4 decimal J 
numbers from 1 through 9999. Do not code leading zeros in n or m. The maximum 
number of digits for n and m combined cannot exceed six. 


Note: RO is equivalent to specifying LOCAL at node Nn. 


nodename.userid 
nodename:userid 
nodename/userid 


nodename(userid) 
Identifies a node and a VM or TSO userid, a remote workstation, or a symbolic name J 
defined at the destination node. The node is a symbolic name defined by the installation 
during initialization; nodename is | through 8 alphanumeric or national ($, #, @) 
characters. The userid must be defined at the node; userid is 1 through 8 alphanumeric 
or national ($, #, @) characters. 


A userid requires a node; therefore, code nodename.userid. You cannot code a userid 
without a nodename. 


If you specify a TSO userid, do not specify a nodename that is the same as the origin ) 
node. 


Note: If a data set is queued for transmission and an operator changes its destination, 
the userid portion of the routing 1s lost. 


Rnonno 

RMnnnn 

RMTnnnn 
Identifies a remote terminal. nnnn is | through 4 decimal numbers from 1 through 9999. 
Note that with remote pooling, the installation may translate this route code to another 
route code. 


Note: RO is equivalent to LOCAL. 
Unnnn 


Identifies a local terminal with special routing. nnnn is 1 through 4 decimal numbers 
from | through 9999. 
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nodename.vmguestid 

nodename:vmguestid 

nodename/ymguestid 

nodename(vmguestid) 
Identifies the network node where the job is to execute. The nodename identifies an MVS 
JES2 system, an MVS JES3 system, a VSE POWER node, or a VM system. If nodename 
specifies the local node, the job executes locally. The nodename is | through 8 
alphanumeric, national ($, #, @), or special characters specified during JES2 initialization. 


The vmguestid identifies a guest system running in a virtual machine (VM), for example, 
an MVS system running under VM. Do not specify a work station or terminal in this 
parameter. 


Location in the JCL 


Place the /“ROUTE statement after the JOB statement and either before or after the EXEC 
statements. Place a /*“ROUTE XEQ statement before all DD * or DD DATA statements in the 
job. 


Processing of /“ROUTE Statements 


e If you do not specify a node on the /“ROUTE PRINT or PUNCH statement, printing or 
punching occurs at the input node. 


@ JES2 processes /*ROUTE XEQ statements on the input node only. 


@ When a /*ROUTE PRINT or PUNCH statement follows a /*ROUTE XEQ statement, 
JES2 processes the /“ROUTE PRINT or PUNCH statement on the execution node only. 
However, printing or punching occurs at the node specified on the /*“ROUTE PRINT or 
PUNCH statement. 


@ When a /*ROUTE PRINT or PUNCH statement precedes a /*ROUTE XEQ statement, 
JES2 processes the /*“ROUTE PRINT or PUNCH statement on both the input and 


execution nodes. However, printing or punching occurs at the node specified on the 
/*ROUTE PRINT or PUNCH statement. 


Multiple /*ROUTE Statements 


JES2 uses the last /*“ROUTE statement of each category, if a job contains more than one 
/*ROUTE PRINT or PUNCH or XEQ statement. 
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Examples of the ROUTE Statement 


/*ROUTE PRINT RMT6 


This statement sends the printed output to remote terminal 6. 


/*ROUTE PUNCH PUN2 


This statement sends the punched output to device PUN2, which was identified to the system 
during initialization. 


//JOBB JOB... 
/*ROUTE XEQ DENVER 
//STEP1 EXEC 


This statement sends the job to the node named DENVER for execution. The entire job is 
scanned for JCL errors on the input system before being transmitted to the target system. The 
entire job is transmitted, which includes the JOBB JOB statement. Options on the JOBB JOB 
statement apply to both the input and target system. 
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/*SETUP Statement 


Purpose: Use the /*SETUP statement to identify volumes that the operator should mount 
before the job is executed. When the job enters the system, JES2 issues a message to the 
operator console, asking the operator to mount the identified volumes. JES2 then places the 
job in hold status until the operator mounts the volumes and releases the job. 


Syntax: 
/*SETUP serial-number[,serial-number]... 
The /*SETUP statement consists of the characters /* in columns 1 and 2, SETUP in columns 


3 through 7, a blank in column 10, and the volume serial number(s) starting in any column 
from 11 through 71. JES2 ignores columns 72 through 80. 


Do not continue the /*SETUP statement; code as many /*SETUP statements as necessary. 


Parameter Definition 
serial-number 
Identifies by serial number the volume(s). A volume serial number is | through 6 
alphanumeric, national ($, #, @), or special characters; enclose a serial number that 


contains special characters, other than hyphens, in apostrophes. If the number is shorter 
than 6 characters, it is padded with trailing blanks. 


Location in the JCL 
Place all /*SETUP statements after the JOB statement and before the first EXEC statement. 
To prevent JES2 from requesting mounting of volumes on a node other than the node of 
execution, the /*“SETUP statement should follow any /*“ROUTE XEQ or /*XEQ statement. If 


JES2 processes the /*“SETUP statement before processing a /*“ROUTE XEQ or /*XEQ 
statement, JES2 requests the setup on both the input and execution nodes. 


Example of the /*“SETUP Statement 


/*SETUP 666321,149658 


This statement requests that volumes 666321 and 149658 be mounted for the job. 
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[*SIGNOFF Statement 


Purpose: Use the /*SIGNOFF statement to tell JES2 to end a remote job stream processing 
session. At the completion of the current print and/or punch streams, JES2 disconnects the 
remote work station from the system. If JES2 is reading jobs from the station when the output 
completes, JES2 disconnects the remote station when the input is completed. 


Note: The remote terminal access processor processes the /*SIGNOFF statement if 1t appears 
in a job stream. 


Both systems network architecture (SNA) and binary synchronous communication (BSC) 
remote work stations can use the /*SIGNOFF statement. SNA remote stations can also use the 
LOGOFF command to end a session with JES2. The LOGOFF command has some options 
that the /*SIGNOFF statement does not provide. 


References: For information on the LOGOFF command, see SPL: JES2 Initialization and 
Tuning and Advanced Communications Function for VTAM Version 2 Programming. 


Syntax: 


/* SIGNOFF 


The /*SIGNOFF statement consists of the characters /* in columns 1 and 2, SIGNOFF in 
columns 3 through 9, and blanks in columns 10 through 80. 


Location in the JCL 


The /*SIGNOFF statement can appear anywhere in a local input stream or an input stream 
from a SNA or BSC remote work station. 


Example of the /*SIGNOFF Statement 


/* SIGNOFF J 


This statement requests that JES2 terminate a remote job stream processing session. 
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[*SIGNON Statement 


Purpose: Use the /*SIGNON statement to tell JES2 to begin a remote job stream processing 
session. For non-multi-leaving remote stations, the terminal transmits the /*SIGNON 
statement alone as part of the initial connection process. 


Note: The remote terminal access processor processes the /*SIGNON statement if it appears in 
a job stream. When the terminal access processor processes the /*SIGNON statement, the line 
being processed is restarted. 


Systems network architecture (SNA) remote work stations must use the LOGON command 
instead of the /*SIGNON statement to notify JES2 of a connection request. 


References: For information on the LOGON command, see SPL: JES2 Initialization and 
Tuning and ACF/VTAM Version 2 Programming. 


Syntax: 


REMOTEnnn 
/*SIGNON RMTnnnn [password1] [password |] 
RMnnnn 
Rnnnn 
NxxRnnnn 
dest-name 


The /*SIGNON statement consists of the following. Note that all the fields in this statement 
must appear in fixed locations. 


Contents 


/*SIGNON 

REMOTEnnon, RMTnonn, RMnnnn, Rnonnn, NxxRnnnn, or dest-name beginning in 16 
password 1, beginning in 25 

password?2, beginning in 73 


Parameter Definition 


REMOTEnnn 
Specifies the identification number assigned to the remote station asking to sign on. nn is 
1 through 3 decimal numbers. 


Code REMOTEnnn with the same characters as RMTnnn on the /*ROUTE statement. 
If you code REMOTEnnn on the /*SIGNON statement, you are restricted to coding 
RMTnnn with only three numbers on the /*ROUTE statement. 


RMTnnnn 

RMannn 

Ronan 
Specifies the identification number assigned to the remote station. nnnn is | through 4 
decimal numbers. 
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NxxRnnnn 
Specifies the node number in the NJE network and the identification number assigned to 
the remote station. Nxx must specify the node to which the remote station is connected. 
xx is | through 1000. nnnn is | through 4 decimal numbers. xx plus nnnn cannot exceed 
6 numbers. 


dest-name 
Specifies the name (1 through 8 characters) that you use to refer to the JES2-defined 
destination. The dest-name must be defined as a remote station on the system to which 
the terminal is connected. 


password! 
Specifies the password assigned to a non-dedicated connection that allows the remote 
station access to JES2 for remote job stream processing. The installation assigns this 
password during JES2 initialization. The operator can change or delete this password 
with the $T command. 


password2 J 
Specifies the password for the remote station that is signing on; this password identifies 
the remote station as a valid remote job entry (RJE) station. The installation assigns this 
password during JES2 initialization. 


Location in the JCL 


Place the /*SIGNON statement at the start of an input stream to be transmitted from a remote 
work station. For non-multi-leaving remote stations, the terminal transmits the /*SIGNON | 
statement alone as part of the initial connection process. | ) 


Place the /*SIGNON statement at the end of the JES2/RTP input stream for multi-leaving 
remote stations. 


Examples of the /*SIGNON Statement 


/ *SIGNON REMOTE12 3LINEPSWD ) 


| This statement requests that remote station 123 begin a remote job stream processing session. 
| LINEPSWD, beginning in column 25, is the password assigned to the non-dedicated 
| connection. 


| /*SIGNON RMT1000 LINEPSWD PSWD2 
This statement requests that remote station 1000 begin a remote job stream processing session. 
LINEPSWD, beginning in column 25, is the password assigned to the non-dedicated 


connection. PSWD2, beginning in column 73, is the password assigned to the remote station 
1000. 


/*SIGNON N11R123 LINEPSWD 
This statement requests that remote station 123 at node 11 begin a remote job stream 


processing session. LINEPSWD, beginning in column 25, is the password assigned to the ) 
non-dedicated connection. 
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/*XEQ Statement 


Purpose: Use the /*XEQ statement to identify the network node where the job is to execute. 
It performs the same function as the /“ROUTE XEQ statement. 


Syntax: 


/*XEQ |Nnnnn 
nodename[.vmguestid] 


The /*XEQ statement consists of the characters /* in columns | and 2, XEQ in columns 3 
through 5, a blank in column 6, and a node starting in any column starting with 7. 


Parameter Definition 


Nnnonn 
Identifies a node. nnnn is | through 4 decimal numbers from | through 1000. For 
example, N0103. 


nodename 
Identifies the network node where the job is to execute. The nodename identifies an MVS 
JES2 system, an MVS JES3 system, a VSE POWER node, or a VM system. If nodename 
specifies the local node, the job executes locally. The nodename is | through 8 
alphanumeric, national ($, #, @), or special characters specified during JES2 initialization. 
vmguestid 


Identifies a guest system running in a virtual machine (VM), for example, an MVS system 
running under VM. Do not specify a work station or terminal in this parameter. 


Location in the JCL 


Place the /*XEQ statement after the JOB statement and either before or after the EXEC 
statements. Place a /*XEQ statement before all DD * or DD DATA statements in the job. 


Multiple /*XEQ Statements 


JES2 uses the last /*XEQ statement, if a job contains more than one /*XEQ statement. 
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Example of the XEQ Statement 


//JOBB JOB ... 
/*XEQ ATLANTA 
//STEP1 EXEC 


JES2 routes and executes this job on the node defined as ATLANTA. The entire job is scanned 
for JCL errors on the input system before being transmitted to the target system. The entire 
job is transmitted, which includes the JOBB JOB statement. Options on the JOBB JOB 
statement apply to both the input and target system. 
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/*XMIT Statement 


Purpose: Use the /*XMIT statement to transmit records from a JES2 node to either another 
JES2 node or an eligible non-JES2 node, for example, a VM or JES3 node. JES2 does not 
process or check the records for JES2 validity. JES2 builds header and trailer records from 
information on the JOB statement immediately preceding the /*XMIT statement. Then JES2 
transmits all the records following the /*“XMIT statement. 


The records may consist of a job input stream or an in-stream DD * or DD DATA data set. If 
the records are a job input stream and the destination node can process JCL, the transmitted 
input stream is executed; in this case, the record immediately following the /*XMIT statement 
must be a JOB statement that is valid at the destination node. 


The records end when JES2 finds one of the following: 


/* in the input stream 

The two-character delimiter specified by a DLM parameter on this /*XMIT statement 
The input stream runs out of card images 

If the records are being read from an internal reader, the internal reader is closed 


Syntax: 


Nnnnn 
nodename 

/*XMIT | nodename.userid [ DLM=xx] 
nodename:userid 
nodename/userid 
nodename (userid) 
nodename.vmguestid 
nodename: vmguestid 
nodename/vmguestid 
nodename (vmguestid) 


The /*XMIT statement consists of the characters /* in columns 1 and 2, XMIT in columns 3 
through 6, a blank in column 7, a nodehame or node-number starting in any column starting 
with 8, and optionally followed, with an intervening blank, by a delimiter parameter. 


Do not continue an /*XMIT statement. 


Parameter Definition 


Nnnonon 
Identifies the destination node. nnnn is | through 4 decimal numbers from | through 
1000. For example, N0O103. 


nodename 
Identifies the destination node. The nodename identifies an MVS JES2 system, an MVS 
JES3 system, a VSE POWER node, or a VM system. The nodename is | through 8 
alphanumeric, national ($, #, @), or special characters specified during JES2 initialization. 
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userid 
Identifies a destination terminal or work station at the node. The userid must be defined 
at the node; userid for TSO is 1 through 7 alphanumeric or national ($, #, @) characters 
and for VM is | through 8 alphanumeric or national ($, #, @) characters. 


Note: If the data set is queued for transmission and an operator changes its destination, 
the userid portion of the original routing is lost. 


vinguestid 
Identifies a destination guest system running in a virtual machine (VM), for example, an 
MVS system running under VM. Do not specify a work station or terminal in this 
parameter. 


Note: If the data set is queued for transmission and an operator changes its destination, 
the vmguestid portion of the original routing 1s lost. 


DLM = xx 
Specifies a two-character delimiter to terminate the data being transmitted. } 


Code any two characters for the delimiter. If the specified delimiter contains any special 

characters, enclose it in apostrophes. In this case, a special character is any character that 

is neither alphanumeric nor national ($, #, @). 

Failing to code enclosing apostrophes produces unpredictable results. 

If the delimiter contains an ampersand or an apostrophe, code each ampersand or 

apostrophe as two consecutive ampersands or apostrophes. Each pair of consecutive 
ampersands or apostrophes counts as one character. ) 
If you specify a DLM parameter, you must terminate the transmitted records with the 

characters in the DLM parameter. The characters you assign as delimiters override any 


delimiter implied by the defaults. 


The characters // are not valid delimiters unless specifically indicated by DLM =//. 


Defaults » 


For the end of the records to be transmitted, the default is /* in the input stream. 


If you specify for DLM only one character or more than two characters, JES2 uses /*. 


i 


Location in the JCL 
Place the /*XMIT statement immediately after a JOB statement. 


Code only one /*XMIT statement in a job. 
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Examples of the XMIT Statement 


//JOBA JOB 
/*XMIT ATLANTA DLM=AA 


records to be transmitted 


AA 


JES2 transmits to the node ATLANTA all records following the /*XMIT statement up to the 
specified delimiter, AA. 


//JOBX JOB ... 
/*XMIT VMSYS1.MVS223 
//JOBB JOB 


job to be transmitted 
/* 


JES2 transmits the JOBB job stream to the VM guest system, MVS223, running on node 
VMSYSI, which is a VM system. The job stream will be executed by the MVS223 system. 


The information specified on the JOBX statement is processed on the submitting system and 
transmitted in the networking headers to the target system. (If the target system is a JES2 
node, this header information is not used.) 
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Chapter 22. JES3 Control Statements 


Code JES3 control statements with JCL statements to control the input and output processing 
of jobs. The rules for coding in Chapter 3, “Format of Statements” and Chapter 4, “Syntax of 
Parameters” apply to the JES3 control statements. 


Location in the JCL 
Place JES3 control statements, except the command and //*PAUSE statements, after the JOB 
statement and its continuations. JES3 ignores. JES3 control statements, except the command 
and //*PAUSE statements, that appear before the JOB statement or between continued JOB 
statements. 


Do not include JES3 control statements in a cataloged or in-stream procedure. JES3 ignores 
JES3 control statements in a procedure. 


Internal Reader 


Use the following control statements when submitting jobs to the internal reader. The internal 
reader is described in SPL: JES3 Initialization and Tuning, and SPL: System Modifications. 


/*DEL 
/*EOF 
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The following shows JES3 control statements in relation to each other and to JCL statements 
for a job entered from a remote work station. No actual job should require all of these 
statements. 


//**MESSAGE,CN1,ENTER A START COMMAND FOR THIS JOB 
//*PAUSE 

//TEST1 JOB  ,,MSGCLASS=A 

//*NETACCT PNAME=MAEBIRD , ACCT=2K14920 

//*NET NETID=N1,NHOLD=0 

//*PROCESS CI 

//*PROCESS MAIN 

//*PROCESS OUTSERV 

//*DATASET DDNAME=STEP1.DD1 


data ) 
/ / *ENDDATASET 


/ /*ENDPROCESS 

//*OPERATOR THIS IS TEST JOB TEST1. 

//*MAIN CLASS=C 

//*FORMAT PR,DDNAME=STEP1.DD2,DEST=ANYLOCAL ,COPIES=2 
//*ROUTE XEQ NODE1 

//FARJOB1 JOB  ,,MSGCLASS=A 

//STEP1 EXEC PGM=CHECKER 

//DD1 DD DSNAME=INPUT 

//DD2 DD SYSOUT=A 


The following is an ordinary job entered through the local input stream. 


/ /RUN2 JOB  ,,MSGCLASS=A 

//*MAIN CLASS=B 

//*FORMAT PR,DDNAME=STEPA.DD2,DEST=ANYLOCAL , COPIES=5 
//STEPA EXEC PGM=WRITER 


//DD1 DD DSNAME=IN1,DISP=OLD, UNIT=3350, VOLUME=SER=MH2244 
//DD2 DD SYSOUT=A . 
/* A 
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JES3 Command Statement 


Purpose: Use the command statement to enter a JES3 operator command through the input 
stream. 


JES3 usually executes an in-stream command as soon as it is read. Therefore, the command 
will not be synchronized with the execution of any job or step in the input stream. To 
synchronize a command with job processing, tell the operator the commands you want and 
when they should be issued, then let the operator enter them from the console. 


References: For more information on the command statement and the JES3 verbs and 
operands, see JES3 Commands. 


Syntax: 


//**command-verb[,operand]... 


The JES3 command statement consists of the characters //** in columns | through 4, the 
command verb beginning in column 5, and, if the command requires operands, a comma 
followed by the operands up through column 72. JES3 ignores columns 73 through 80. 


Do not continue command statements from one statement to the next. 


Parameter Definition 


*command-verb 
Indicates one of the following JES3 commands. Do not specify a *DUMP or *RETURN 
command on a JES3 command statement. 


Command Short Form 


CALL 


lS, 

ey) 

oe 

> 

ne 
m2AnodK 


rs) 
tr 
4 
> 
rs) 
<' 
YHWON 


< 
> 
~ 
o. 
< 


operand 
Specifies an operand that pertains to the command-verb. 
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Location in the JCL 


@ Place JES3 command statements before the first JOB statement in the input stream, if jobs 
are also being submitted. JES3 treats any JES3 command statements that follow the JOB 
statement as comment statements. 


e You can enter several command statements at one time. 


e You can place command statements at the beginning of the cards in an active card reader 
that is being restarted. 


@¢ Command statements can be entered through card, tape, or disk readers. 


e Command statements cannot be entered through an internal reader or from another node. 


Examples of the Command Statement 


//**VARY ,280 ,OFFLINE 
//**V,281,OFFLINE 
//**VARY , 282 ,OFF 


//**V , 280-282, OFF 


In this example, the first three statements each vary one device offline. Alternatively, the fourth 
statement varies all three devices offline. If you place these cards in card reader 01C, for 
example, and it is currently not in use, the operator would enter through the operator console: 


*X CR,IN=01C 


//**MESSAGE,CN1,OUTPUT FROM JOB X REQUIRES SPECIAL CONTROLS 


This statement instructs the operator from a remote location. Place this statement before the 
first job in the input stream. 


22-4 MVS/XA JCL Reference 


JES3: //*DATASET 


//* DATASET Statement 


C 


Purpose: Use the //*DATASET statement to identify the beginning of an in-stream data set, 
| which can contain JCL and/or data. (The //*ENDDATASET statement ends the in-stream 
| data set.) The data set can be used as input to a dynamic support program (DSP), such as 
OUTSERV. 


Note: Make sure the operator includes a C operand on the *CALL command for the reader 
that reads a job containing this statement if it contains a MODE=C parameter. 


Syntax: 


//*DATASET DDNAME=ddname[,parameter]... 
The parameters are: 
sc 


6: 


J=|YES 
NO 


MSGCLASS 


CLASS= |NO 
class 


| The //*DATASET statement consists of the characters //* in columns | through 3, 
( DATASET in columns 4 through 10, a blank in column 11, and parameters in columns 12 
| through 72. JES3 ignores columns 73 through 80. 


Parameter Definition 


DDNAME = ddname 
Specifies the name of the in-stream data set that follows the //*DATASET statement. 


MODE=E 
eS MODE=C 
Defines the card-reading mode. 
E 


Indicates that JES3 is to read the cards as EBCDIC with validity checking. E is the 
default if the MODE parameter is omitted. 


Indicates that JES3 is to read the cards in card image form, that is, in column 
binary or data mode 2. 


MODE =C is not valid for jobs read from disk or tape, or for jobs submitted from 
remote work stations. 
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J=YES 
J=NO 
Indicates how JES3 is to recognize the end of the data set. 


If you specify MODE=C, JES3 ignores the J parameter; therefore, use a 
//*ENDDATASET statement to end the data set. 


YES 
Indicates that a //*ENDDATASET statement ends the data set. Specify YES when 
JOB statements appear in the data set. 


NO 
Indicates that a JOB statement ends the data set. NO is the default if the J 
parameter is omitted, unless MODE=C is specified. 
CLASS = NO 
CLASS = MSGCLASS 
CLASS = class 
Identifies the output class JES3 is to use for the data set. 
NO 
Indicates that the system is to assign an output class. If you omit the CLASS 
parameter, the default is NO. 
MSGCLASS 
Requests the output class in the MSGCLASS parameter on the JOB statement. 
class 


Specifies the output class. 


Location in the JCL 


Place a //*DATASET statement immediately before the first record of an in-stream data set. 
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Example of the //* DATASET Statement 


//*PROCESS OUTSERV 
//*DATASET DDNAME=MYPRINT,J=YES 


data 
/ /*ENDDATASET 


//*FORMAT PR,DDNAME=MYPRINT,COPIES=5 
//STEPI1 EXEC ... 


In this example, the //*DATASET statement marks the beginning of the in-stream data set 
MYPRINT. The //*FORMAT PR statement requests five copies of it. A //*“ENDDATASET 
statement marks the end of the data set. 
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//*ENDDATASET Statement 


Purpose: Use the //"ENDDATASET statement to indicate the end of an in-stream data set 
that was begun with a //*DATASET statement. 


Syntax: 


//*ENDDATASET 


The //*ENDDATASET statement consists of the characters //* in columns | through 3 and 
ENDDATASET in columns 4 through 13. Columns 14 through 80 must be blank. 


Location in the JCL 


Place a //*ENDDATASET statement immediately after the last record of an in-stream data set 
that was begun with a //*DATASET statement. 


Example of the //*ENDDATASET Statement 


//*DATASET DDNAME=INFO, J=YES 
data 
/ /*ENDDATASET 


In this example, the //*ENDDATASET statement marks the end of the in-stream data set 
INFO. 
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|/*ENDPROCESS Statement 


Purpose: Use the //"ENDPROCESS statement to indicate the end of a series of //*PROCESS 
statements in a job. 


Syntax: 


//*ENDPROCESS [comments] 


The //*ENDPROCESS statement consists of the characters //* in columns | through 3, 
ENDPROCESS in columns 4 through 13, a blank in column 14, and, optionally, comments 
starting in any column beginning with 15. JES3 ignores columns 73 through 80. 


Location in the JCL 


Place a //*ENDPROCESS statement immediately after the last //*PROCESS statement in a 
job. The //*ENDPROCESS statement is optional if a JCL statement follows the last 
//*PROCESS statement. 


Do not place any //*PROCESS statements after the //FENDPROCESS statement. 


Example of the //* ENDPROCESS Statement 


/ /*ENDPROCESS END OF PROCESS STATEMENTS 
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//*FORMAT PR Statement 


Purpose: Use the //*FORMAT PR statement to specify to JES3 processing instructions for 
sysout data sets that are printed. These instructions permit special processing of sysout data 
sets, such as: 


Multiple destinations. 

Multiple copies of output with different attributes. 
Forced single or double space control. 

Printer overflow checking. 


You can code several //*FORMAT PR statements for one sysout data set to specify special 
requirements for different copies of the data set. You can also code a //*FORMAT PU 
statement for the same sysout data set, thereby both printing and punching it. 


Note: The //*FORMAT PR statement applies only to sysout data sets printed by JES3. The 
statement is ignored for data sets sent to a TSO userid or processed by an external writer. 


References: For additional information, refer to the output services topic in SPL: JES3 
Intitialization and Tuning. 


Syntax: 


//*FORMAT PR,DDNAME= (stepname.ddname [,parameter]... 
stepname.procstepname.ddname 
SYSMSG 
JESJCL 
JESMSG 


//*FORMAT PR,DDNAME=[,parameter]... 


The parameters are: 


CARRIAGE= |carriage-tape-name 
6 
FCB= |} image-name 
6 
CHARS= |STANDARD 
table-name 
(table-name[,table-name]...) 


CHNSIZE= |DS 
(nnn[,mmm] ) 


COMPACT=compact ion-table-name 


CONTROL= | PROGRAM 
SINGLE 
DOUBLE 
TRIPLE 


COPIES= |nnn 
(nnn, (group-value[,group-value]... 
(group-value[,group-value]...) 


22-10 MVS/XA JCL Reference 


ANYLOCAL 

device-name 
device-number 
group-name 
nodename[.remote] 
(type[,device-name] ) 
(type[,device-number] ) 
(type[,group-name] ) 


EXTWTR=name 
FLASH= | STANDARD 
over lay-name 


(overlay-name[,count] ) 


FORMS= |STANDARD 
form-name 


MODIFY= |/module-name | 


(module-name[,trc] ) 


OVFL= JON 
OFF 
PRTY=nnn 
STACKER=! STANDARD 
S 
C 
THRESHLD=limit 


TRAIN= |STANDARD 
train-name 


JES3: //*FORMAT PR 


The //*FORMAT PR statement consists of the characters //* in columns 1 through 3, 
FORMAT in columns 4 through 9, a blank in column 10, PR in columns 11 and 12, a 
comma in column 13, and parameters in columns 14 through 72. JES3 ignores columns 73 
through 80. 


Parameter Definition 


PR 


Indicates that this statement is associated with a sysout data set that is printed. 
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DDNAME= 

DDNAME = stepname.ddname 

DDNAME = stepname.procstepname.ddname 
DDNAME=SYSMSG 

DDNAME = JESJCL 

DDNAME = JESMSG 


(null) 
Specifies that the parameters on this //*FORMAT PR statement are the defaults for 
the job. These parameters then apply to all of the job’s sysout data sets that are 
printed, except those covered by a //*FORMAT PR statement with 
DDNAME =ddname. 


Nonspecific and Specific Statements: A //“FORMAT PR statement that contains 
DDNAME = _§s1s called nonspecific; a statement that contains DDNAME=ddname 
is called specific. 


Overrides: Parameters coded on a nonspecific //*FORMAT PR statement are 
overridden by parameters coded on sysout DD statements or by parameters in the 
JES3 SYSOUT initialization statement. 


stepname.ddname 

stepname. procstepname.ddname 
Identifies the DD statement that defines the sysout data set to be printed. Use form 
stepname.ddname to indicate DD statement, ddname, in step, stepname, in this job. 
Use form stepname.procstepname.ddname to indicate DD statement, ddname, in 
procedure step, procstepname, of a procedure that is called by a step, stepname, in 
this job. The ddname must match exactly the ddname on the DD statement. (See 
the example for the //*DATASET statement.) If the identified DD statement does 
not contain a SYSOUT parameter, JES3 ignores the //*FORMAT PR statement. 


SYSMSG 
Requests printing of system messages. 


JESJCL 
Requests printing of JCL statements and messages. 


JESMSG 
Requests printing of JES3 and operator messages about the job. 


CARRIAGE = carriage-tape-name 

CARRIAGE = 6 
Specifies the carriage tape for the 3211, 3203 Model 5, or 1403 Printer for printing this 
output class. 


carriage-tape-name 
Identifies the name of the carriage tape. The name is | through 8 characters. 


For the 3211 and 3203-5, SYS1.IMAGELIB must contain a module for each 
carriage tape name. 


Indicates the installation standard carriage tape. 
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Note: You cannot code both the CARRIAGE and FCB parameters on the same 
//*FORMAT PR statement. 


CHARS =STANDARD 

CHARS = table-name 

CHARS = (table-name|,table-namel]...) 
Requests one or more character-arrangement tables for printing the sysout data set on a 
3800 Printing Subsystem. 


STANDARD 
Indicates the standard character-arrangement table, which was specified at JES3 
Initialization. 


table-name 
Identifies a character-arrangement table. Each table-name is | through 4 
alphanumeric or national ($, #, @) characters. When coding more than one 
table-name, parentheses are required around the list and null positions are invalid in 
the list. 


CHNSIZE=DS 

CHNSIZE = (nnn[,mmm]) 
Gives the number of logical records to be transmitted to a work station as a systems 
network architecture (SNA) chain and indicates whether normal output checkpoints are to 
be taken for this sysout data set. 


Note: This parameter is valid only when transmitting to a SNA work station. 


Be careful in selecting subparameters, because each affects performance differently. 
Sending the data set as a SNA chain provides the best performance, but can cause 
duplicate data to be written to the output device if operator intervention is required. The 
remote operator can eliminate duplicate data by issuing commands to reposition and 
restart the output writers. 


When an end-of-chain indicator is sent in the data set, JES3 takes an output checkpoint. 
You can provide additional checkpoints for critical data by sending an end-of-chain 
indicator. For example, when printing bank checks, you can have an output checkpoint 
taken for each check by specifying each check as a SNA chain. 


DS 
Indicates that the sysout data set 1s to be sent as a single SNA chain and that JES3 
is to take normal output checkpoints. DS is the default if the CHNSIZE parameter 
is omitted. 

nnn 
Specifies the SNA chain size in pages. nnn is a decimal number from | through 
255. The size of a page is determined by: 
@ The value of mmm. 
e The carriage control characters in the data that skip to channel 1. 

mmm 


Specifies the number of logical records in a page, when the data contains no 
carriage control characters. mmm is a decimal number from | through 255. 
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COMPACT =compaction-table-name 
Specifies the compaction table for JES3 to use when sending a systems network 
architecture (SNA) data set to a SNA remote terminal. The compaction-table-name is a 
symbolic name defined by the installation during JES3 initialization. The name is 1 
through 8 alphanumeric characters. 


In the following cases, JES3 performs compaction using an installation default table, if 
defined, or sends the data without compacting it, if no table was defined. In all cases, 
JES3 writes a message to the console. 


e Nocompaction table is specified. 
e The specified compaction table is invalid. 
e JES3 cannot find the specified compaction table. 


If the remote printer does not support compaction, JES3 ignores the COMPACT 
parameter and sends the data without compacting it. 


CONTROL = PROGRAM 

CONTROL = SINGLE 

CONTROL = DOUBLE 

CONTROL = TRIPLE 
Indicates either that the data records control printing or that the output is to be printed 
with single, double, or triple spacing. 


PROGRAM 
Indicates that each logical record in the sysout data set begins with a carriage 
control character. The carriage control characters can be in either the extended 
USASCII code or can be the actual channel command code. The carriage control 
characters are given in the Data Administration Guide. 


SINGLE 
Requests single spacing. 


DOUBLE 
Requests double spacing. 


TRIPLE 
Requests triple spacing. 


COPIES = nnn 

COPIES = (nnn,(group-value|,group-value]...)) 

COPIES = (group-value|,group-value]...) 
Indicates how many copies of the sysout data set are to be printed. If a COPIES 
parameter is not specified, the default is 1. 


nnn 
Specifies how many copies of the sysout data set are to be printed; each copy will be 
in page sequence order. nnn is a number from 0 through 255. If you code 
COPIES =0, JES3 does not print this data set. You can omit the parentheses if you 
code only nnn. JES3 ignores nnn if any group-values are specified. 


22-14 MVS/XA JCL Reference 


JES3: //*FORMAT PR 


group-value 
Specifies how many copies of each page are to be printed before the next page is 
printed. Each group-value is a number from | through 255. You can code a 
maximum of eight group-values. Their sum must not exceed 255. The total copies 
of each page equals the sum of the group-values. 


This subparameter is valid only for output on a 3800 Printing Subsystem. Group 
values override an nnn subparameter. 


DEST = destination 
Routes the output from the sysout data set to a printer. This parameter overrides the 
//*MAIN statement ORG parameter. 


If you omit DEST, JES3 assigns the first available printer that is in the origin group and 
that fulfills all processing requirements. The origin group is the group of printers defined 
for the local or remote submitting location. If the job originated at a remote job 
processing (RJP) terminal, JES3 returns the output to the originating terminal group. 


ANYLOCAL 
Indicates any local printer that is being used for the output class specified in the 
SYSOUT parameter on the DD statement and that is attached to the global 
processor. 


device-name 
Requests a local device by a symbolic name defined by the installation during JES3 
initialization. device-name is | through 8 alphanumeric or national ($, #, @) 
characters. 


device-number 
Specifies the 3-character device number. 


group-name 
Identifies a group of local devices, an individual remote station, or a group of 
remote stations by a symbolic name defined by the installation during JES3 
initialization. group-name is | through 8 alphanumeric or national ($, #, @) 
characters. 


nodename 
Identifies a node by a symbolic name defined by the installation during JES3 
initialization. nodename is 1 through 8 alphanumeric or national ($, #, @) 
characters. 


remote 
Identifies a remote work station or VM userid to which the receiving node directs 
output. remote is | through 8 characters. 


(type) 
Indicates a device classification. type is in the form (gggssss) where ggg is the 
general device classification and ssss is the specific device classification. The type 
must be enclosed in parentheses. The type must be defined by the installation 
during JES3 initialization. For example, type for a 3800 is (PRT3800). 
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EXTWTR =name 
Identifies the external writer that is to process the sysout data set at the destination node. 
name is | through 8 alphanumeric characters and must identify a module defined to the 
remote JES3 node that is to execute the job. (Do not code NJERDR, it is reserved for 
JES3.) 


FCB =image-name 

FCB=6 
Specifies the forms control buffer (FCB) image JES3 is to use to guide printing of the 
sysout data set by a 1403 Printer, 3211 Printer, 3203 Printer Model 5, 4245 Printer, 4248 
Printer, or 3800 Printing Subsystem, or by a printer supported by systems network 
architecture (SNA) remote job processing (RJP). 


If the data set is to be produced on some other device, JES3 ignores the FCB parameter. 
image-name 


Identifies the FCB image. The name is | through 4 alphanumeric or national (§, #, 
@) characters and is the last characters of a SYS1.IMAGELIB member name: 


@ FCB2xxxx member for a 3211, 3203 model 5, or printer supported by SNA. 
e FCB3xxxx member for a 3800. 
@ FCB4xxxx member for a 4248. 


6 
Indicates the standard FCB. JES3 uses the standard FCB specified at JES3 
initialization. 
Note: You cannot code both the CARRIAGE and FCB parameters on the same J 


//*FORMAT PR statement. 


FLASH = STANDARD 

FLASH = overlay-name 

FLASH = (overlay-name|,count]) 
Identifies the forms overlay to be used in printing the sysout data set on a 3800 Printing 
Subsystem and, optionally, to specify the number of copies on which the forms overlay is 


to be printed. 
) 


You can omit the parentheses if you code only an overlay-name. If you omit the count 
subparameter or specify a count of 0, JES3 flashes all copies with the specified overlay. 


STANDARD 
Indicates the standard forms flash overlay. JES3 uses the standard forms overlay 
specified at JES3 initialization. 


overlay-name 
Identifies the forms overlay frame that the operator is to insert into the printer 
before printing begins. The name is | through 4 alphanumeric or national ($, #, @) 


characters. 
count 
Specifies the number, 0 through 255, of copies that JES3 is to flash with the overlay, 
beginning with the first copy printed. Code a count of 0 to flash all copies. ) 
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Note: See the Forms Design Reference Guide for the IBM 3800 Printing Subsystem for 
information on designing and making forms overlays. 


FORMS = STANDARD 
FORMS = form-name 
Indicates the forms on which the sysout data set is to be printed. 


STANDARD 
Indicates the standard form. JES3 uses the standard form specified at JES3 
initialization. 


form-name 
Names the print forms. form-name is 1 through 8 alphanumeric characters. 


MODIFY = module-name 

MODIFY = (module-name[,trc]) 
Specifies a copy modification module that tells JES3 how to print the sysout data set on a 
3800 Printing Subsystem. The module can specify how to replace blanks or data in the 
data set. You can omit the parentheses if you code only a module-name. 


The module is defined and stored in SYS1.IMAGELIB using the IEBIMAGE utility 
program. See the Data Administration: Utilities for more information. 


If you omit the tre subparameter, JES3 prints the data set with the first 
character-arrangement table coded in the CHARS parameter. 


module-name 
Identifies a copy modification module in SYS1.IMAGELIB. module-name is 1 
through 4 alphanumeric or national ($, #, @) characters. 


tre 
Identifies which table-name in the CHARS parameter is to be used. This table 
reference character is 0 for the first table-name specified, 1 for the second, 2 for the 
third, or 3 for the fourth. 


OVFL=ON 
OVFL = OFF 
Indicates whether or not the printer program should test for forms overflow. 


Because the overflow test is a responsibility of the terminal package for the remote RJP 
terminal, JES3 ignores OVFL for remote job processing. 


ON 
Indicates that the printer program should eject whenever the end-of-forms indicator 
(channel 12) is sensed. ON is the default if the OVFL parameter is omitted. 


OFF 
Indicates that forms overflow control is not to be used. 


PRTY = nnn 


Specifies the priority at which the sysout data set enters the output queue. nnn isa 
decimal number from 0 through 255; 0 is the lowest priority while 255 is the highest. 
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STACKER = STANDARD 
STACKER =S 
STACKER =C 
Requests a stacker for 3800 Printing Subsystem output. 


STANDARD 
Indicates the standard installation default. This default is specified at JES3 
initialization. 


Indicates the burster-trimmer-stacker, in which the output is burst into separate 
sheets. 


Indicates the continuous forms stacker, in which the output is left in continuous 
fanfold. 


THRESHLD = limit 
Specifies the maximum size for the sysout data set. JES3 calculates the sysout data set 
size as the number of records multiplied by the number of copies requested. When this 
size exceeds the THRESHLD value, JES3 creates a new unit of work, on a data set 
boundary, and queues it for printing. Consequently, copies of the sysout data set may be 
printed simultaneously by different printers. 


Use the THRESHLD parameter for jobs that generate many large sysout data sets. 
Grouping data sets as a single unit of work for an output service writer may decrease the 
time required for the output service writer to process the data sets. 


The value specified in this parameter overrides the value specified during JES3 
initialization. 


limit 
Specifies the maximum records for a single sysout data set. limit is a decimal 
number from 1 through 99999999. The default is 99999999. 


TRAIN = STANDARD 

TRAIN = train-name 
Indicates the printer train to be used in printing the sysout data set. See Figure 10-2 on 
page 10-171 for the IBM-supplied trains. Because these trains are not standard machine 
features, verify that the installation has the required printer train before specifying it. 


Do not code the TRAIN parameter for output destined for a remote job processing (RJP) 
terminal. 


STANDARD 
Indicates the standard installation default. This default is specified at JES3 
initialization. 

train-name 


Specifies an installation-supplied printer train. Check with your installation for the 
names of trains. 


22-18 MVS/XA JCL Reference 


JES3: //*FORMAT PR 


Relationship to Sysout DD and OUTPUT JCL Statements 


e JES3 ignores the processing options specified on a default //*“FORMAT statement when a 
sysout DD statement explicitly or implicitly references an OUTPUT JCL statement. 


e JES3 ignores the processing options specified on a default OUTPUT JCL statement when a 
//*FORMAT statement explicitly references a sysout DD statement. 


e When a sysout DD statement explicitly references an OUTPUT JCL statement and a 
//*FQORMAT statement explicitly references the same DD statement, the processing options 
from both the OUTPUT JCL and //‘FORMAT statements apply. Two separate sets of 
output are created from the data set defined by the sysout DD statement; one according to 


the processing options on the OUTPUT JCL and DD statements, and the other according 
to the processing options on the //‘FORMAT and DD statements. 


Relationship to //* PROCESS Statement 


JES3 accumulates //*FORMAT PR statements within a job and applies them to any JES3 
//*PROCESS statement that is normally affected by a //*“FORMAT PR statement. 


Location in the JCL 


Place all //*FORMAT PR statements for the job after the JOB statement and before the first 
EXEC statement. 


Examples of the //*FORMAT PR Statement 


//*FORMAT PR,DDNAME=STEP1.REPORT,COPIES=2 


This statement requests two copies of the data set defined by sysout DD statement REPORT, 
which appears in STEP1 of this job. Any printer with standard forms, train, and carriage tape 
can be used. 


//*FORMAT PR,DDNAME=, DEST=ANYLOCAL 


This statement specifies that all sysout data sets not referenced by //*FORMAT PR statements 
are to be printed on any local printer. 
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[/*FORMAT PU Statement 


Purpose: Use the //‘FORMAT PU statement to specify to JES3 processing instructions for 
sysout data sets that are punched. These instructions permit special processing of sysout data 
sets, such as: 


@ Miultiple destinations. 
@ Multiple copies of output with different attributes. 


You can code several //-FORMAT PU statements for one sysout data set to specify special 
requirements for different copies of the data set. You can also code a //*FORMAT PR 


statement for the same sysout data set, thereby both printing and punching it. 


Note: The //*FORMAT PU statement applies only to sysout data sets punched by JES3. The 
statement is ignored for data sets sent to a TSO userid or processed by an external writer. 


Syntax: 


//*FORMAT PU,DDNAME= |stepname.ddname [,parameter]... 
stepname.procstepname.ddname 


//*FORMAT PU,DDNAME=[,parameter]... 
The parameters are: 


CHNSIZE= |DS 
(nnn[ ,mmm] ) 


COMPACT=compaction-table-name 


COPIES=nnn 


ANYLOCAL 

device-name 
device-number 
group-name 
nodename[.remote] 
(type[,device-name |] ) 
(type[,device-number] ) 


(type[,group-name] ) ) 


EXTWTR=name 


FORMS= | STANDARD 
form-name 


INT= | YES 
NO 


The //*FORMAT PU statement consists of the characters //* in columns | through 3, 
FORMAT in columns 4 through 9, a blank in column 10, PU in columns 11 and 12, a 
comma in column 13, and parameters in columns 14 through 72. JES3 ignores columns 73 
through 80. 
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Parameter Definition 


PU 
Indicates that this statement is associated with a sysout data set that is punched. 


DDNAME= 
DDNAME = stepname.ddname 
DDNAME =stepname.procstepname.ddname 


(null) 
Specifies that the parameters on this //*FORMAT PU statement are the defaults for 
the job. These parameters then apply to all of the job’s sysout data sets that are 
punched, except those covered by a //*FORMAT PU statement with 
DDNAME = ddname. 


Nonspecific and Specific Statements: A //*FORMAT PU statement that contains 
DDNAME = §s1s called nonspecific; a statement that contains DDNAME=ddname 
is called specific. 


Overrides: Parameters coded on a nonspecific //*FORMAT PU statement are 
overridden by parameters coded on sysout DD statements or by parameters in the 
JES3 SYSOUT initialization statement. 


stepname.ddname 

stepname.procstepname.ddname 
Identifies the DD statement that defines the sysout data set to be punched. Use 
form stepname.ddname to indicate DD statement, ddname, in step, stepname, in this 
job. Use form stepname.procstepname.ddname to indicate DD statement, ddname, in 
procedure step, procstepname, of a procedure that is called by a step, stepname, in 
this job. The ddname must match exactly the ddname on the DD statement. (See 
the example for the //*DATASET statement.) If the identified DD statement does 
not contain a SYSOUT parameter, JES3 ignores the //*FORMAT PU statement. 


CHNSIZE = DS 

CHNSIZE = (non[,mmm]) 
Gives the number of logical records to be transmitted to a work station as a systems 
network architecture (SNA) chain and indicates whether normal output checkpoints are to 
be taken for this sysout data set. 


Note: This parameter is valid only when transmitting to a SNA work station. 


Be careful in selecting subparameters, because each affects performance differently. 
Sending the data set as a SNA chain provides the best performance, but can cause 
duplicate data to be written to the output device if an operator intervention is required. 
The remote operator can eliminate duplicate data by issuing commands to reposition and 
restart the output writers. 


When an end-of-chain indicator is sent in the data set, JES3 takes an output checkpoint. 
You can provide additional checkpoints for critical data by sending an end-of-chain 
indicator. For example, when punching bank checks, you can have an output checkpoint 
taken for each check by specifying each check as a SNA chain. 
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DS 
Indicates that the sysout data set is to be sent as a single SNA chain and that JES3 
is to take normal output checkpoints. DS 1s the default if the CHNSIZE parameter 
is omitted. 


non 
Specifies the SNA chain size in pages. nnn is a decimal number from 1 through 
255. The size of a page is determined by the value you assign to mmm. 


mmm 
Specifies the number of logical records in a page. mmm is a decimal number from 1 
through 255. 


COMPACT = compaction-table-name 
Specifies the compaction table for JES3 to use when sending a systems network 
architecture (SNA) data set to a SNA remote terminal. The compaction-table-name is a 
symbolic name defined by the installation during JES3 initialization. The name is 1 
through 8 alphanumeric characters. J 


In the following cases, JES3 performs compaction using an installation default table, if 
defined, or sends the data without compacting it, if no table was defined. In all cases, 
JES3 writes a message to the console. 


e No compaction table is specified. 
e The specified compaction table is invalid. 
e JES3 cannot find the specified compaction table. 


If the remote punch does not support compaction, JES3 ignores the COMPACT 
parameter and sends the data without compacting it. 


COPIES = nnn 
Indicates how many copies of the sysout data set are to be punched. nnn is a number 
from 0 through 255. If you code COPIES =0, JES3 does not punch this data set. Ifa 
COPIES parameter is not specified, the default is 1. 


DEST = destination 
Routes the output from the sysout data set to a punch. This parameter overrides the ’ 
//*MAIN statement ORG parameter. ) 


If you omit DEST, JES3 assigns the first available punch that is in the origin group and 
that fulfills all processing requirements. The origin group is the group of punches defined 
for the local or remote submitting location. If the job originated at a remote job 
processing (RJP) terminal, JES3 returns the output to the originating terminal group. 


ANYLOCAL 
Indicates any local punch that is being used for the output class specified in the 
SYSOUT parameter on the DD statement and that is attached to the global 
processor. 


device-name 


Requests a local device by a symbolic name defined by the installation during JES3 
initialization. device-name is 1 through 8 alphanumeric or national ($, #, @) 


characters. 4 
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device-number 
Specifies the 3-character device number. 


group-name 
Identifies a group of local devices, an individual remote station, or a group of 
remote stations by a symbolic name defined by the installation during JES3 


initialization. group-name is 1 through 8 alphanumeric or national ($, #, @) 
characters. 


nodename 
Identifies node by a symbolic name defined by the installation during JES3 


initialization. nodename is 1 through 8 alphanumeric or national ($, #, @) 
characters. 


remote 


Identifies a remote work station or VM userid to which the receiving node directs 
output. remote is 1 through 8 characters. 


(type) 
Indicates a device classification. type is in the form (gggssss) where ggg is the 
general device classification and ssss is the specific device classification. The type 
must be enclosed in parentheses. The type must be defined by the installation 
during JES3 initialization. For example, type for a 3525 is (PUN3525). 


EXTWTR = name 


Identifies the external writer that is to process the sysout data set at the destination node. 
name is 1 through 8 alphanumeric characters and must identify a module defined to the 
remote JES3 node that is to execute the job. 


FORMS = STANDARD 
FORMS = form-name 
Indicates the forms on which the sysout data set is to be punched. 


STANDARD 
Indicates the standard form. JES3 uses the standard form specified at JES3 
initialization. 

form-name 
Names the punch forms. form-name is 1 through 8 alphanumeric characters. 


INT = YES 
INT=NO 


Specifies whether or not the output is to be interpreted. If the INT parameter is omitted, 
the default is NO. 


YES 


Requests that JES3 try to punch the sysout data set on a 3525 Card Punch 
(PUN3525]) with a Multiline Card Print feature. 


Note: If the DEST parameter does not send output to a 3525], JES3 ignores 
INT = YES, if specified. 


NO 
Requests that the cards not be interpreted. 
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Relationship to Sysout DD and OUTPUT JCL Statements 


e JES3 ignores the processing options specified on a default //*FORMAT statement when a 
sysout DD statement explicitly or implicitly references an OUTPUT JCL statement. 


e JES3 ignores the processing options specified on a default OUTPUT JCL statement when a 
//*FORMAT statement explicitly references a sysout DD statement. 


@e When a sysout DD statement explicitly references an OUTPUT JCL statement and a 
//*FORMAT statement explicitly references the same DD statement, the processing options 
from both the OUTPUT JCL and //*FORMAT statements apply. Two separate sets of 
output are created from the data set defined by the sysout DD statement; one according to 
the processing options on the OUTPUT JCL and DD statements, and the other according 
to the processing options on the //*FORMAT and DD statements. 


Relationship to //* PROCESS Statement 


JES3 accumulates //*FORMAT PU statements within a job and applies them to any JES3 J 
//*PROCESS statement that is normally affected by a //*FORMAT PU statement. 


Location in the JCL 


Place all //*FORMAT PU statements for the job after the JOB statement and before the first 
EXEC statement. 


Example of the //*FORMAT PU Statement 


//*FORMAT PU,DDNAME=STEP2.PUNCHOUT , DEST=PU1,FORMS=RED-STRP 
This statement requests that one copy of the data set defined by sysout DD statement 


PUNCHOUT in STEP2 of this job be punched on device PU1. Before processing, the operator 
is requested to insert RED-STRP cards into the punch. 
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//*MAIN Statement 


Purpose: Use the //*MAIN statement to define the processor requirements for the current job. 
Many of the parameters are used to override parameters on the JES3 STANDARDS 
initialization statement. 


Note: If any parameter is misspelled or contains an invalid value, JES3 writes the following to 
the JESMSG data set: the //*MAIN statement, the relative error position on the statement, 
and an error message. Then JES3 abnormally terminates the job. 


Syntax: 


//*MAIN parameter[,parameter]... 
The parameters are: 
ACMAIN=processor-id 


BYTES= |([nnnnnn][,WARNING] [,mmm] ) 
({nnnnnn)] [,W] [,mmm] ) 
([nnnnnn] [,CANCEL] ) 
({nnnnnn] [,C] ) 

({nnnnnn] [,DUMP] ) 
({mnnnnn][,D]) 


CARDS= |([nnnn] [ ,WARNING] [,mmm] ) 
({nnnn] [,W] [,mmm] ) 
({nnnn] [,CANCEL] ) 
({nnnnj][,C]) 
({nnnn] [,DUMP] ) 
({nnnn][,D]) 


CLASS=class-name 


DEADLINE= |(time,typel[,date] ) 
(time,type[,rel,cycle] ) 


EXPDTCHK= |YES 
NO 


FAILURE= |RESTART 
CANCEL 
HOLD 
PRINT 


FETCH= (ALL 
NONE 
SETUP 
(ddname[,ddname]...) 
/(ddname[,ddname]...) 


HOLD=| YES 
NO 


HIGH 


IORATE=| MED 
LOW 


JOURNAL=] YES 
NO 
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LINES= |([nnnn] [,WARNING] [ ,mmm] ) 
({[nnnn] [,W] [,mmm] ) 
({nnnn] [,CANCEL] ) 


({nnnn)][,C] ) 
({nnnn] [,DUMP] ) 
({nnnn][,D]) 


LREGION=nnnnk 


MS S= | JOB 
HWS 

ORG= |group-name 

nodename[.remote] 

PAGES= |( [nnnnnnnn] [ ,WARNING] [ ,mmm] ) 
({nnnnnnnn] [,W] [,mmm] ) 
({nmnnnnnnn] [,CANCEL] ) 
({nnnnnnnn]j[,C]) 

({nnnnnnnn] [,DUMP] ) : j 
({nnnnnnnn][,D]) 
PROC= |ST 
xX 
RINGCHK= | YES 
NO 

SETUP= ]JOB 

HWS 


THWS 

DHWS ») 
(stepname.ddname[,stepname.ddname]...) 
(stepname.procstepname.ddname[,stepname.procstepname.ddname]...) 
/(stepname.ddname[,stepname.ddname]...) 


(stepname.procstepname.ddname[,stepname.procstepname.ddname]...) 
SPART=partition-name 


SYSTEM= (ANY 
JGLOBAL 
JLOCAL 
(main-name[,main-name]...) j 


/(main-name[,main-name]...) 
THWSSEP= | IGNORE 

PREFER 

REQUIRE 
TRKGRPS=(primary-qty,second-qty) 


TYPE= | ANY 
VS2 


UPDATE=(dsname[,dsname]...) 


USER=userid 
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The //*MAIN statement consists of the characters //* in columns | through 3, MAIN in columns 4 


through 7, a blank in column 8, and parameters in columns 9 through 72. JES3 ignores columns 73 
through 80. 


Parameter Definition 


ACMAIN = processor-id 
Identifies the job with the specified processor, even though the job was not submitted 
from or executed on that processor. This parameter has no effect if it specifies the 
processor that the job runs on. ACMAIN allows: 


e Sysout data sets to be sent to a userid attached to the specified processor. The userid 
must be named in the USER parameter. The ACMAIN parameter applies to all 
sysout data sets for the job. 


e A job termination message to be sent automatically to a userid attached to the 
specified processor. The userid must be named in the JOB statement NOTIFY 
parameter. 


processor-id 
Requests a processor in the complex. 


BYTES = ({nnnnnnj|,WARNING]|,mmn]) 

BYTES = ({nnnnnoj|, W]|,mmm}]) 

BYTES = ({nnnnnonj[/,CANCEL]) 

BYTES = ({nnnnnnj|[,C]) 

BYTES = ({nnnnnnj|.DUMP)) 

BYTES = ({nnnnnnj|[,D]) 
Specifies the maximum number of bytes of data to be spooled from this job’s sysout data 
sets and the action to be taken if the maximum is exceeded. 


If BYTES its not specified, the installation default for this job class applies. 
nnnnon 
Specifies the number of bytes in thousands. nnnnnn is 1 through 6 decimal numbers 


from 1 through 999999. 


WARNING or W 
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operator when 100,000 bytes of sysout data is reached. Subsequent warning 
messages are sent when each additional 20 percent of 100,000 is reached (at 
120,000 bytes, 140,000 bytes, and so on). Messages are sent until the job ends 
or the operator cancels the job. 


CANCEL or C 
If the maximum is exceeded, requests that JES3 cancel the job. 


DUMP or D 
If the maximum is exceeded, requests that JES3 cancel the job and ask for a storage 
dump. 


CARDS = ({nnnn][,WARNING]|,mmm]) 

CARDS = ((nnnnj[,W][,mmm]) 

CARDS = ({nnnnj[,CANCEL}) 

CARDS = ((nnnnj[,C]) 

CARDS = ({nnnnj[, DUMP)) 

CARDS = ({nnnnj[,D)) 
Specifies the maximum number of cards to be punched from this job’s sysout data sets 
and the action to be taken if the maximum is exceeded. 


If you specify CARDS =0 the zero applies only to the quantity of punched output; it 
does not cancel the action to be taken if the maximum is exceeded. If a record is then 
sent to a punch, JES3 will warn, cancel, or dump, depending on the second parameter. 


Note: When punching dump output, JES3 ignores CARDS=0. 
If CARDS is not specified, the installation default for this job class is used. 


nnnn 
Specifies the number of cards in hundreds. nnnn is | through 4 decimal numbers 
from 1 through 9999. 


WARNING or W 
If the maximum is exceeded, requests that JES3 issue an operator warning message 
and continue processing. 


Any subsequent messages about this parameter will reflect the number specified on 
the STANDARD initialization statement or the system default, not the maximum 
specified in the CARDS parameter. 
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CANCEL or C 
If the maximum is exceeded, requests that JES3 cancel the job. 


DUMP or D 
If the maximum is exceeded, requests that JES3 cancel the job and ask for a storage 
dump. 


CLASS = class-name 
Specifies the job class for this job. class-name is 1 through 8 characters. 


If the desired class-name is a single-character, you can specify it on the //*MAIN 
statement or the JOB statement. 


JES3 uses the following, in override order, to assign the job to a class: 


1. //*MAIN statement CLASS parameter 
2. JOB statement CLASS parameter 
3. The default class, which is defined during JES3 initialization. 


If neither CLASS nor LREGION is specified, JES3 determines the logical region size 
based on initialization parameters. 


DEADLINE = (time, type|,date]) 
DEADLINE = (time, type|,rel,cycle]) 
Specifies when the job is required. 


When you specify the current date but submit the job after the specified time, JES3 
changes the priorities to make the job the same priority level it would have if it had been 
submitted before the deadline but not completed. 


Warning: Deadline scheduling can interfere with dumping a portion of the job queue. 
For example, if JOB A is waiting to be scheduled, has a priority of 7, and, in one minute, 
is due to have its priority increased to 9, JOB A could be missed by dump job processing, 
if the dump job facility is dumping the entire job queue and currently dumping priority 8 
jobs. The dump job facility processes the jobs with the highest priority first. If the dump 
job facility does not finish processing priority 8 jobs before JOB A becomes priority 9, 
JOB A will not be dumped. 


Deadline scheduling information is not sent with a job when the job is transferred via 
NJE to another node; the destination node may use different deadline scheduling 
algorithms, if any. 


time 
Specifies the deadline time, expressed as one of the following: 


nM 
The job is to be scheduled within n minutes. n is 1 through 4 numbers from 0 
through 1440. 

nH 
The job is to be scheduled within n hours. n is 1 or 2 numbers from 0 
through 24. 
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hhhh 
The job is to be scheduled by the time of day, hhhh, in 24-hour clock time 
(0800 is 8:00 a.m.). hhhh is from 0000 (start of the day) through 2400 (end of 
the day). 


type 
Identifies the deadline algorithm. The deadline algorithm is defined by the 
installation, controls how the job’s priority is increased, and is one character: A 
through Z or 0 through 9. If the specified algorithm is not defined, JES3 
abnormally terminates the job. 


date 
Specifies the date when the time parameter takes effect. The date is in the format 
mmddyy, where mm is the month (01-12), dd the day (01-31), and yy the year 
(00-99). 


If both date and rel,cycle are omitted, JES3 assumes (1) the current date, if the 
deadline time is later in the day, or (2) the next day’s date, if the deadline time has 
already past today. 


rel 
Specifies on which day within a cycle the deadline falls. rel is 1 through 3 numbers 
from 1 through 366. The value of rel depends on the specified cycle, as follows: 


@e WEEKLY: Sunday is day 1; Saturday is day 7. If rel is greater than 7, it 
defaults to 7. 


e MONTHLY: Day 1 Is the first day of the month. Days 29, 30, and 31 are 
treated as the last day of the month. If rel is greater than 31, it defaults to 31. 


e YEARLY: Day 1 in January 1; day 365 is December 31, for regular years, and 
day 366 is December 31, for leap years. If rel is greater than 365, it defaults to 
365 for regular years or 366 for leap years. 


cycle 
Specifies the length of a cycle. cycle is coded as WEEKLY, MONTHLY, or 
YEARLY. 


For example, DEADLINE = (1200,B,1,WEEKLY) indicates that the job reaches its 
deadline at 12 noon on Sunday. 


EXPDTCHK = YES 

EXPDTCHK =NO 
Indicates whether or not JES3 is to perform expiration date checking for scratch output 
tape volumes with IBM standard labels (SL). 


YES 
Requests expiration date checking. Tape volumes premounted for SL scratch 
requests must have expired dates. 


NO 
Requests that expiration dates not be checked. 
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FAILURE = RESTART 

FAILURE = CANCEL 

FAILURE = HOLD 

FAILURE= PRINT 
Indicates the job recovery option to be used if the system fails. If you do not code a 
FAILURE parameter on the //*MAIN statement, JES3 assigns the job the default failure 
option, which is defined during JES3 initialization for each job class. (See also the RD 
parameter on the JOB statement.) 


RESTART 
Requests that JES3 restart the job when the failing processor is restarted. Do not 
specify RESTART for jobs that use the DEQ at DEMOUNT facility for tape 
volumes. 


CANCEL 
Requests that JES3 print the job and then cancel the job. 


HOLD 
Requests that JES3 hold the job for restart. 


PRINT 
Requests that JES3 print the job and then hold the job for restart. 


FETCH = ALL 

FETCH = NONE 

FETCH =SETUP 

FETCH = (ddname[,ddname]...) 

FETCH = /(ddname|,ddnamel...) 
Determines the fetch messages that will be issued to the operator for disk and tape 
volumes for this job. 


If FETCH is not specified, the installation default for this job class applies. 


ALL 
Requests that JES3 issue fetch messages to the operator for all removable volumes 
specified in DD statements that request JES3-setup devices. This subparameter does 
not apply to permanently resident volumes. 


NONE 
Requests that JES3 not issue fetch messages. 


SETUP 
Requests that JES3 issue fetch messages to the operator for the volumes specified in 
all DD statements identified in the //*MAIN SETUP parameter. If you code 
FETCH = SETUP without also coding the //*MAIN SETUP parameter, JES3 will 
issue fetch message as though you had specified FETCH = ALL. 


ddname 
Requests that JES3 issue fetch messages for only the volumes specified in DD 


statement ddname. 


If you code a list of ddnames and the list cannot be contained on a single statement, 
FETCH= must be repeated on the continuation statement. 
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/ddname 
Requests that JES3 not issue fetch messages for any volumes specified in DD 
statement ddname. 


HOLD = YES 
HOLD=NO 


YES 
Indicates that the job is to enter the system in operator-hold status and be withheld 
from processing until the operator requests its release. However, if an error occurs 
during input service processing, the job is not held for operator intervention. 


This parameter has the same function as TYPRUN =HOLD on the JOB statement. 
NO 


Indicates that the job is to enter the system normally. Processing does not require 
operator intervention. If the HOLD parameter is omitted, NO is the default. 


IORATE =MED 

IORATE = HIGH 

IORATE = LOW 
Indicates the I/O-to-processor ratio for a job. Use this parameter to balance the mixture 
of jobs selected for execution on the processor. 


If you do not code an IORATE parameter on the //*MAIN statement, JES3 assigns the 
job the default I/O-to-processor ratio, which is defined during JES3 initialization for each , 
job class. ) 


JOURNAL = YES 
JOURNAL =NO 
Indicates whether or not JES3 is to create a job journal for the job. 


If JOURNAL is omitted, JES3 uses an installation default specified at initialization. 


YES 
Indicates that the job is to have a job journal. ) 


NO 
Indicates that the job is not to have a job journal. 


LINES = ({nnnn][,WARNING]|,mmm]) 

LINES = ({nnnn][, W]|,mmm]}) 

LINES = ({nnnnj[,CANCEL) 

LINES = ({nnnn}jj,C}) 

LINES = ({nnnnj[, DUMP)) 

LINES = ({nnnn]j[,D}) 
Indicates the maximum number of lines of data to be printed from this job’s sysout data 
sets and the action to be taken if the maximum is exceeded. 


If you specify LINES=0 the zero applies only to the number of lines; it does not cancel 
the action to be taken if the maximum is exceeded. Ifa record is sent to be printed, JES3 
will warn, cancel, or dump, depending on the second parameter. 
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Note: JES3 ignores any line count specification when printing the output fora 
SYSABEND or SYSUDUMP sysout data set. 


If LINES is not specified, the installation default for this job class applies. 


nnnn 
Specifies the number of lines, in thousands. nnnn is | through 4 decimal numbers 
from 1 through 9999. 


WARNING or W 
If the maximum is exceeded, requests that JES3 issue an operator warning and 
continue processing. 


Any messages about this parameter following the warning message will reflect the 
number specified on the STANDARD initialization statement or the system default, 
not the maximum specified in the LINES parameter. 


mmm 
Specifies the frequency that an operator warning message is to be issued after 
the maximum specified by nnnn is exceeded. mmm is a multiple of 10 in the 
range 10 to 100. mmm is a percentage of nnnn that is used to calculate the 
number of additional lines between warning messages. For example, if 
LINES = (100,W,20) is specified, the first warning message is sent to the 
operator when 100,000 lines of sysout data is reached. Subsequent warning 
messages are sent when each additional 20 percent of 100,000 is reached (at 
120,000 lines, 140,000 lines, and so on). Messages are sent until the job ends 
or the operator cancels the job. 


CANCEL or C 
If the maximum is exceeded, requests that JES3 cancel the job. 


DUMP or D 
If the maximum is exceeded, requests that JES3 cancel the job and ask for a storage 
dump. 


LREGION = nnnnK 
Specifies the approximate size of the largest step’s working set in real storage during 
execution. LREGION (logical region) is used by JES3 to improve scheduling on the 
processor. The nnnn is | through 4 decimal numbers that indicate the size in kilobytes (1 
kilobyte = 1024 bytes). 


If neither CLASS nor LREGION is coded, JES3 determines the logical region size based 
on initialization parameters. 


Use the LREGION parameter carefully. If the values selected for LREGION are too 
small, the job may take longer to run. 


MSS = JOB 

MSS = HWS 
Indicates that the job uses mass storage system (MSS) and specifies how JES3 should 
allocate the MSS virtual units. This parameter overrides the installation default defined 
at JES3 initialization. 
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JOB 


Specifies that each request for an MSS volume is to be assigned to a separate virtual 
unit. 


HWS 


Specifies that virtual units are to be reused in subsequent job steps in order to 
minimize the number of units needed for the job. 


Note: The MSS and SETUP parameters on the //*MAIN statement can specify different 
types of allocation. For example, MSS can specify JOB while SETUP can specify HWS. 


ORG = group-name 
ORG = nodename|.remote] 
Indicates that the job’s sysout data sets are to be directed to the named group or network 


node. Otherwise, the job’s sysout data sets are directed to the group of devices or node 
from which the job originated. 


proup-name 
Specifies an origin group. 


nodename 
Specifies a network node. nodename is | through 8 characters. 


remote 


Specifies a remote work station or VM userid. remote is | through 8 characters and 
must be separated from the nodename by a period. 


Overriding an ORG Parameter: If you do not want a particular data set in the job to go 
to the destination on the ORG parameter, change its destination in one of the following 
ways: 


e If the sysout data set is not scheduled to a held class, you can override the ORG 
parameter destination with the DEST parameter on a //*FORMAT, OUTPUT JCL, 
or DD statement. 


e Ifthe sysout data set is scheduled to a held class, you can override the ORG 


parameter destination with the DEST parameter on an OUTPUT JCL, or DD ) 
Statement. 


PAGES = ({nnnnnonnn]|,WARNING||,mmm]) 

PAGES = ({nnnannnnn][, W][,mmm]) 

PAGES = ({nnnnnnnn]|,C ANCEL])) 

PAGES = ({nnnnnnnn][,C]) 

PAGES = ({nnnannnnn]|[, DUMP]) 

PAGES = ({nnnannnnn][,D]) 
Indicates the maximum number of pages to be printed for this job’s sysout data sets and 
the action to be taken if the maximum is exceeded. 


If PAGES is not specified, the installation default for this job class applies. 


hnnnnnnnn 


Specifies the number of pages. nnnnnnnn is | through 8 decimal numbers from 1 
through 16777215. 
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WARNING or W 
If the maximum is exceeded, requests that JES3 issue an operator warning message 
and continue processing. 


Any messages about this parameter following the warning message will reflect the 
number specified on the STANDARD initialization statement or the system default 
value, not the maximum specified in the PAGES parameter. 


mmm 
Specifies the frequency that an operator warning message is to be issued after 
the maximum specified by nnnnnnnn is exceeded. mmm is a multiple of 10 in 
the range 10 to 100. mmm is a percentage of nnnnnnnn that is used to 
calculate the number of additional pages between warning messages. For 
example, if PAGES =(1000,W,20) is specified, the first warning message is sent 
to the operator when 1,000 pages of sysout data is reached. Subsequent 
warning messages are sent when each additional 20 percent of 1,000 is reached 
(at 1,200 pages, 1,400 pages, and so on). Messages are sent until the job ends 
or the operator cancels the job. 


CANCEL or C 
If the maximum is exceeded, requests that JES3 cancel the job. 


DUMP or D 
If the maximum 1s exceeded, requests that JES3 cancel the job and ask for a storage 
dump. 


PROC =ST 

PROC = xx 
Names the procedure library that the system is to search for cataloged procedures called 
by EXEC statements in the job. If a procedure cannot be found in the named library, 
JES3 abnormally terminates the job. 


If this parameter is omitted, the default depends on the source of the job. If the job is 
submitted as a batch job, the default is ST. If the job is submitted from an internal 
reader, the default may be another procedure library, as specified by the installation. 


ST 
Indicates the standard procedure library: SYS1.PROCLIB. 


XX 
Identifies the last 2 characters of the ddname of a procedure library. xx is defined 
by the installation. If this parameter is coded, only the specified library is searched; 
SYS1.PROCLIB is not searched. 


RINGCHK = YES 

RINGCHK = NO 
Indicates whether or not JES3 is to check the status of the tape reel ring for tape devices 
set up by JES3. 


YES 


Indicates that a validation check is to be made. If the RINGCHK parameter is 
omitted, YES is the default. 
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NO 
Indicates that ring checking is to be by-passed for this job. 


SETUP = JOB 

SETUP =HWS 

SETUP = THWS 

SETUP = DHWS 

SETUP = (stepname.ddname|,stepname.ddnamel...) 

SETUP = (stepname.procstepname.ddname|,stepname.procstepname.ddnamel...) 

SETUP = /(stepanme.ddname|,stepname.ddname]...) 

SETUP = /(stepanme.procstepname.ddname|,stepname.procstepname.ddname]...) 
Modifies the standard setup algorithm used in assigning devices to a job before its 
execution. 


If SETUP is omitted, JES3 assigns mountable tape and disk volumes based on an 
installation default defined at initialization. 


JOB 
Requests job setup, which is allocation of all JES3-managed devices required in the 
job before the job executes. JES3 mounts the initial volumes necessary to run all 
steps before the job executes. JOB overrides the SETUP parameter on the JES3 
STANDARDS initialization statement. 


HWS 
Requests high watermark setup, which is allocation of the minimum number of 
devices required to run the job. The minimum number is equal to the greatest 
number of devices of each type needed for any one job step. High watermark setup 
does not cause premounting of all mountable volumes. 


THWS 
Requests high watermark setup for tapes but job setup for disks. 


DHWS 
Requests high watermark setup for disks but job setup for tapes. 


stepname.ddname 

stepname.procstepname.ddname 
Specifies explicit setup, which is allocation of the volumes needed for a DD 
statement before the job executes. JES3 premounts the indicated volumes. When 
requesting explicit setup, specify enough devices so that JES3 can allocate all the 
required devices at any one time. If too few devices are specified, JES3 cancels the 
job. 


Use form stepname.ddname to indicate DD statement, ddname, in step, stepname, in 
this job. Use form stepname.procstepname.ddname to indicate DD statement, 
ddname, in procedure step, procstepname, of a procedure that is called by a step, 
stepname, in this job. The ddname must match exactly the ddname on the DD 
statement. (See the example for the //*DATASET statement.) 


If you code a list of ddnames and the list cannot be contained on a single statement, 
SETUP= must be repeated on the continuation statement. 
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/stepname.ddname 

/stepname.procstepname.ddname 
Requests that JES3 not explicitly set up any volumes specified in DD statement 
ddname. 


SPART = partition-name 
Indicates the spool partition in which JES3 is to allocate spool space to this job. 


partition-name 
Specifies the name of the spool partition. partition-name is | through 8 characters 
and must match a partition name specified during JES3 initialization. If the name 
does not match, JES3 ignores the SPART parameter and uses the installation 
default. 


The SPART parameter does not affect allocation for the sysout data sets for the job; 
these data sets always go to the spool partitions specified during JES3 initialization for 
the output classes. 


If SPART is not specified, JES3 allocates spool data sets to a partition, as follows, in 
override order: 


1. The spool partition for the job’s class. 
2. The spool partition for the processor executing the job. 
3. The default spool partition. 


SYSTEM = ANY 

SYSTEM = JGLOBAL 

SYSTEM = JLOCAL 

SYSTEM = (main-name[,main-name]...) 

SYSTEM = /(main-name[,main-name]...) 
Indicates the processor that is to execute this job. If a specific processor 1s named, the 
processor name must also be specified on the CLASS initialization statement for the job 
class. 


ANY 
Indicates any global or local system that satisfies the job’s requirements. 


JGLOBAL 
Indicates that the job is to run on the global processor only. 


JLOCAL 
Indicates that the job is to run on a local processor only. 


main-name 
Indicates that the job is to run on the named processor or processors. 


/main-name 
Indicates that the job is not to run on the named processor or processors. 


Need for SYSTEM Parameter: If you omit a SYSTEM parameter, the job runs on the 
processor used for the job’s class. Usually a SYSTEM parameter is not needed. 
However, if any DD statement UNIT parameter in the job specifies a device-number, a 
SYSTEM parameter must be coded. 
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Parameter Agreements: The following parameters must be consistent with the SYSTEM 
parameter or JES3 will terminate the job: 


e CLASS parameter on the JOB or //*MAIN statement. The requested processor must 
be assigned to execute jobs in the specified class. 


e All devices specified on DD statement UNIT parameters must be available to the 
requested processor. 


e TYPE parameter on the //*MAIN statement must specify the system running on the 
requested processor. 


e Dynamic support programs requested on //*PROCESS statements must be able to be 
executed on the requested processor. 


THWSSEP = IGNORE 
THWSSEP = PREFER 
THWSSEP = REQUIRE J 
Indicates whether or not you want scratch tape requests and specific tape requests 
separated during high watermark processing. This parameter is valid only if high 
watermark setup (HWS or THWS) is specified on the SETUP parameter or defined at 
JES3 initialization. 


Use this parameter to direct scratch and specific tape requests to different tape drives (for 
example, you may want JES3 to allocate only scratch tape requests to an IBM 3480 that 
is equipped with an automatic cartridge loader). 


If you omit THWSSEP, JES3 uses an installation default defined at initialization. J 


IGNORE 
Specifies that JES3 is not to separate scratch and specific tape requests during high 
watermark processing. Both scratch and specific tape requests can be allocated on 
the same tape drive. 


PREFER 
Specifies that JES3 attempt to allocate scratch and specific tape requests on separate 
tape drives without allocating additional devices. If JES3 cannot separate the - 
requests, scratch and specific tape requests are allocated on the same tape drive. 


REQUIRE 
Specifies that JES3 should not allocate scratch and specific tape requests on the 
same tape drive, even if JES3 must allocate additional tape drives to satisfy the 
request. 


TRKGRPS = (primary-qty,second-qty) 
Specifies the number of track groups to be assigned to the job. A track group is a 
number of spool space allocation units. The size of the track group is defined in the 
GRPSZ parameter on the JES3 BUFFER or SPART initialization statement. 


primary-qty 
Specifies the number of track groups to be initially allocated. This quantity is one 
decimal number from 1 through 9. 
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second-qty 
Specifies the number of track groups to be allocated when the currently allocated 
groups are filled and more space is needed. This quantity is one decimal number 
from | through 9. 


The //*MAIN TRKGRPS parameter overrides a TRKGRPS parameter on the CLASS or 
MAINPROC initialization statement. However, when a sysout DD statement specifies an 
output class, the TRKGRPS parameter for that output class overrides the //*MAIN 
TRKGRPS parameter. 


TYPE =ANY 

TYPE=VS2 
Indicates the control program that is to execute this job. If you omit a TYPE parameter, 
the job runs under the control program used for the job’s class. 


ANY 
Indicates that JES3 is to use any control program that satisfies the job’s 
requirements. In present systems, JES3 schedules the job on MVS. 


VS2 
Indicates that JES3 is to schedule the job on MVS. 


UPDATE = (dsname|,dsname]...) 
Identifies the procedure library data set(s) that this job is to update. This parameter 
causes all jobs using the identified data set and any concatenated data sets to be held until 
the update is complete. See JES3 Initialization and Tuning for information about 
updating procedure libraries. 


dsname 
Specifies the data set name. The identified data set cannot be concatenated to 
another data set. 


USER = userid 
Identifies the job with the specified TSO user, even though the job was not submitted via 
TSO by that user. USER allows: 


e The TSO userid, interacting with a global or local processor, to issue the TSO 
OUTPUT command to access sysout data sets from the job. If the job executes on 
one processor and the TSO userid is attached to another processor, the ACMAIN 
parameter must identify the processor for the TSO userid. 


e The TSO userid, interacting with any processor, to inquire about the status of the job 
or to cancel the job. 


userid 


Identifies a TSO user. userid is 1 through 7 alphanumeric or national ($, #, @) 
characters. 
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Location in the JCL 


Place the //*MAIN statement for a job after the JOB statement and before the first EXEC - 
statement. 


When you specify ORG on a //*MAIN statement, place the //*MAIN statement before all 
//*FORMAT statements that do not contain a DEST parameter. If JES3 does not process the 
ORG parameter before the //*FORMAT statements, JES3 uses the default destination for the 
//*FORMAT statements; their output is sent to the node where the job entered the system. 


When you specify ORG on a //*MAIN statement that is part of a remote job, place the 
//*MAIN statement immediately after the second JOB statement. 


Examples of the //* MAIN Statement 


//*MAIN SYSTEM=SY1,LINES=(5,C) ,SETUP=HWS, ) 
//*FAILURE=RESTART , DEADLINE=(0800,A,3,WEEKLY) 


The job executes on processor SY1. It is estimated to produce not more than 5000 lines of 
printed output; if the output exceeds 5000 lines, JES3 is to cancel the job. HWS specifies high 
watermark setup, so JES3 is to allocate the minimum number of devices required for this job. 
If the system fails, JES3 is to restart the job on the processor SY1. JES3 is to complete this job 
by 8 a.m. on Tuesday (Tuesday is day number 3) by adjusting the job’s scheduling priority 
using the installation-defined A-type deadline scheduling parameters. 


//*MAIN ACMAIN=2 , USER=GARYHIL 2 


If this statement appears in a job entered from any TSO userid on any processor in the 
complex, then the job’s sysout data sets would go to TSO userid GARYHIL on processor 2. 
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[[*NET Statement 


Purpose: Use the //*NET statement to define the dependencies between jobs in a dependent 
job control (DJC) network. JES3 sets up a network of dependent jobs and executes them in a 
specific order. (Once set up, the structure of a DJC network cannot be changed unless all of 
the jobs in the network are resubmitted.) 


Syntax: 


//*NET |NETID |=name[,parameter]... 
ID 


The parameters are: 


— NOKP 
KEEP 


a | 


NORMAL |= |p 
NC F 
R 

RIS Re Fannie OS cinsh enh 


NET 


ns 


=(netid, jobname) 


vlad 


The //*NET statement consists of the characters //* in columns 1 through 3, NET in 
columns 4 through 6, a blank in column 7, and parameters in columns 8 through 72. JES3 
ignores columns 73 through 80. 
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Parameter Definition 


NETID = name 
Specifies the name of the DJC network for this job. name is | through 8 characters; the 
first character must be alphabetic. 


All jobs put into the system with the same NETID name form a DJC network. To adda 
job to an existing DJC network, specify the NETID name for that job. 


ABCMP=NOKP 
ABCMP = KEEP 
Indicates what action JES3 is to take if the job abnormally terminates. 


NOKP 
Indicates that JES3 is to purge the DJC network if the job abnormally terminates 
and has not been resubmitted by the time the other jobs in the network have 
completed. JES3 purges the network unless successor jobs or subnetworks are 
missing. If the ABCMP parameter is omitted, NOKP is the default. 


KEEP 
Indicates that the DJC network is to be kept in the system until (1) the job is 
resubmitted and completes normally or (2) the operator forces the network from the 
system. Use KEEP to make sure that the network is not purged until the operator 
takes proper action. 


Note: If the job abnormally terminates, you can resubmit it to the DJC network, and the 
network will be retained until the job completes. 


ABNORMAL=D 

ABNORMAL =F 

ABNORMAL=R 

NORMAL=D 

NORMAL =F 

NORMAL=R 
Indicates the action JES3 is to take for this job when any predecessor job completes 
execution normally or abnormally. If the ABNORMAL parameter is omitted, the default 
is R, and, if the NORMAL parameter is omitted, the default is D. 


D 
Requests that JES3 decrease this job’s NITOLD count, which indicates the number 


of predecessors for this job. When the NHOLD count becomes zero, JES3 can 
schedule this job. 


Requests that JES3 flush this job and its successor jobs from the system. JES3 
cancels the job, prints any output, and cancels all successor jobs presently in the 
system, regardless of their normal or abnormal specifications. However, JES3 
admits into the system all successor jobs that enter after the DJC network has been 
flushed. To flush those jobs, the operator must cancel the jobs or the network. 


Requests that JES3 retain this job in the system and not decrease the NHOLD 
count. R suspends the job and its successor jobs from scheduling until either the 
predecessor job is resubmitted or the operator decreases the NHOLD count. 
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DEVPOOL =(ANY[,device-name,n]...[,SDGxx]...) 

DEVPOOL = (NET|,device-name,n]...[,SDGxx]...) 
Identifies devices to be dedicated to this DJC network. The system allocates these devices 
only to jobs in the network. The DEVPOOL parameter should be coded on the //*NET 
statement that establishes the network; it is ignored on other //*NET statements. 


ANY 
Indicates that jobs in the network can use any dedicated or undedicated device. 
JES3 tries to allocate from the dedicated pool before allocating any undedicated 
devices. 


NET 
Indicates that jobs can use only devices dedicated to the network. 


device-name,n 
Identifies a dedicated device. Code as many device-names with numbers as will fit 
on one statement. device-name specifies (1) a device name defined to JES3 by the 
installation during initialization or (2) a device-type specified in the UNIT 
parameter of an IODEVICE system generation macro instruction. See Installation: 
System Generation for a list of IBM device types. nis the number of named devices. 
n is a number from | through 32767. 


SDGxx 
Identifies a mass storage system (MSS) staging drive group to be pooled (fenced) for 
the DJC network. xx is the staging drive group number. 


DEVRELSE= YES 

DEVRELSE = NO 
Indicates when devices dedicated to the DJC network are to be released. The 
DEVRELSE parameter can be coded in several jobs in the network, but must not be 
coded in the first job. If no network job containing DEVRELSE = YES completes, the 
system releases the devices when it purges the network. 


YES 
Requests that JES3 release all devices at the end of this job. Completion of any job 
that specified DEVRELSE= YES causes the devices dedicated to the network to be 
released. 


NO 
Requests that JES3 release all devices only when the last job in the network ends. 


NETREL = (netid,jobname) 
Indicates that this job must be executed before the named job in another DJC network 
can be executed. The NETREL parameter can be specified only once for each job of a 
DJC network. 


netid 
Identifies the NETID for the successor job. 


jobname 
Names the JOB statement for the successor job. 
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NHOLD =n 
Indicates the number of predecessor job completions required before this job can be 
released for scheduling. The predecessor number can include jobs from another DJC 
network. nis a number from 0 through 32767. 


When the predecessor number reaches 0, the job is scheduled for execution. The system 
reduces this number: 


@ When each predecessor job completes execution. 
e By operator command. 


@ When a program in a predecessor job issues an assembler DJC WTO macro. See 
Supervisor Services and Macro Instructions for details. 


If you specify NHOLD =0 or omit the NHOLD parameter, this job has no predecessor 
jobs. JES3 can schedule it for immediate execution. 


If the NHOLD count is incorrect, the following can occur: 


e Ifnis greater than the actual number of predecessor jobs, JES3 does not release this 
job for execution when all of its predecessor jobs complete execution. 


e If nis less than the actual number of predecessor jobs, JES3 prematurely releases the 
job for execution. 


NRCMP=HOLD 

NRCMP = NOHO 

NRCMP = FLSH 
Indicates that a network job that completed normally is being resubmitted and that JES3 
must erase all references to the job before the job reenters the network. 


HOLD 
Indicates that JES3 is to hold the job until it is released by the operator. 


NOHO 


Indicates that JES3 1s to allow the job to be scheduled as system resources become } 
available. 


FLSH 
Indicates that JES3 is to flush the job from the system. 


OPHOLD=NO 
OPHOLD = YES 


NO 
Indicates that the job is to be processed normally without operator intervention. If 
OPHOLD is omitted, NO is the default. 


YES 
Indicates that JES3 is to hold the job until it is released by the operator. 
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RELEASE = (jobname],jobname]...) 
Indicates that this job must be executed before the named job(s) in this DJC network can 
be executed. 


jobname 
Names the JOB statement for a successor job. You can specify from 1 through 50 
successor jobnames. 


RELEASE is the only parameter on the //*NET statement that can be split and continued 
on the next statement. To continue the RELEASE parameter, end the statement with the 
comma following a jobname and continue the next statement with the next jobname. The 
left parenthesis appears at the beginning of the jobname list and the right parenthesis 
appears at the end of the list. For example: 


//*NET NETID=EXP1,RELEASE=(J0B35,J0B27Z,MYJOB, 
/ /*WRITJB , JOBABC) 


RELSCHCT =n 
Controls early set up of a dependent job’s resources. Set up begins when the NHOLD 


count becomes less than or equal to n. nis a number from | through 32767. 


If you specify RELSCHCT =0 or omit the RELSCHCT parameter, JES3 does not set up 
dependent jobs early. 


Note: Use this parameter carefully; RELSCHCT can tie up devices and data sets for 
long times. Do not specify the RELSCHCT parameter: 


e Fora job that may have catalog dependencies. 
@ For a job that contains one or more //*PROCESS statements. 


Location in the JCL 


Place the //*NET statement for a job after the JOB statement and before the first EXEC 
statement. Code only one //*NET statement for each job in a DJC network. 


The //*NET statement must precede any //*PROCESS statements. 


Examples of the //* NET Statement 


//*NET NETID=NETO1,NHOLD=0 , DEVPOOL=(,3330,2) 

This statement defines a DJC network named NETO1. The network contains no predecessor 
jobs. The DEVPOOL parameter, which must be coded in the first job in the network, requests 
that JES3 establish a device pool of two 3330s for network NETO1. 


//*NET NETID=N1,RELEASE=B ,NETREL=(N2,B2) 


This statement adds a job to the DJC network named N1. This job must be executed before 
job B, which is in N1, and before job B2, which is in the DJC network named N2. 
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[/*NETACCT Statement 


Purpose: Use the //*NETACCT statement to specify accounting information that JES3 is to 
transmit with a job to another node in the network. 


Syntax: 


//*NETACCT parameter[,parameter]... 
The parameters are: 


PNAME=programmer 's-name 
ACCT=number 
BLDG=address 

DEPT=dept 

ROOM=room 
USERID=userid 


e The //*NETACCT statement consists of the characters //* in columns 1 through 3, 
NETACCT in columns 4 through 10, a blank in column 11, and parameters in columns 
9 through 72. JES3 ignores columns 73 through 80. 


Do not continue a //*NETACCT statement. If the parameters cannot fit on one 
statement, code more than one //*NETACCT statement. 


Enclose any parameter value that contains special characters, including embedded 
blanks, in apostrophes. 


Parameter Definition 


PNAME = programmer’s-name 
Identifies the programmer. programmer’s-name is | through 20 characters. 


ACCT = number 
Gives the network account number. number is 1 through 8 characters. 


BLDG = address 
Gives the programmer’s building address. address is | through 8 characters. 


DEPT = dept 
Gives the programmer's department number. dept is 1 through 8 characters. 


ROOM = room 
Gives the programmer’s room number. room is | through 8 characters. 


USERID = userid 
Gives the programmer’s network userid. userid is 1 through 8 characters. 
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Defaults 


For any //*NETACCT parameter that is omitted, JES3 uses an installation default specified at 
JES3 initialization. 


Location in the JCL 


Place the //*NETACCT statement(s) for a job stream to be transmitted immediately after the 
first JOB statement and before any //*ROUTE XEQ statements. 


Example of the //* NETACCT Statement 


//*NETACCT PNAME=COLLINS , ACCT=D58D921,USERID=NXT 
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//* OPERATOR Statement 


Purpose: Use the //*OPERATOR statement to issue a message to the operator. Columns 1 
through 80 are written on the operator console and in the job’s hard-copy log when JES3 reads 
in the job. 


Syntax: 


//*OPERATOR message 


The //*OPERATOR statement consists of the characters //* in columns | through 3, 
OPERATOR in columns 4 through 11, a blank in column 12, and the message for the 
operator in columns 13 through 80. 


Location in the JCL 


Place the //*OPERATOR statement anywhere after the JOB statement. 


Example of the //*OPERATOR Statement 


//*OPERATOR CALL EXT. 55523 WHEN THIS JOB STARTS 
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//*PAUSE Statement 


Purpose: Use the //*PAUSE statement to halt an input reader temporarily. When.you enter a 
//*PAUSE statement through an input reader, JES3 issues a message and waits for the operator 
to reply. To start the input reader, the system operator must issue a *START command ora 
remote work station with console level 15 must send a start message. 


The //*PAUSE statement is intended primarily for system checkout and test. It should be 
issued only by remote work stations. 


Syntax: 


//*PAUSE [comments] 


The //*PAUSE statement consists of the characters //* in columns | through 3, PAUSE in 
columns 4 through 8, blanks in columns 9 and 10, and, optionally, comments starting in any 
column beginning with 11. JES3 ignores columns 73 through 80. 


Location in the JCL 


Place the //*PAUSE statement before the first JOB statement in an input stream. If it appears 
after the first JOB statement, JES3 ignores it. 


Example of the //*PAUSE Statement 


//*PAUSE THIS IS A TEST. 
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//*PROCESS Statement 


Purpose: Use the //*PROCESS statement to control how JES3 processes a job. A job that 
contains //*PROCESS statements receives only the JES3 processing specified on the 
//*PROCESS statements plus certain required processing. 


Specifically, the //*PROCESS statement calls a dynamic support program (DSP) in the DSP 
dictionary. JES3 must be able to process the called DSP. 


Standard Job Processing: JES3 uses a series of processing functions to process a job. Standard 
processing consists of only the standard scheduler functions: 


Converter/interpreter service 
Main service 

Output service 

Purge service 


Nonstandard Job Processing: A nonstandard job uses one or more special processing functions 

in place of or in addition to standard processing or skips one or more of the standard functions. 
Specify a nonstandard job by following the JOB statement with a JES3 //*PROCESS statement 
for each processing function. 


Use of Nonstandard Job Processing: Nonstandard job processing is useful in testing. For 

example, a //*-PROCESS statement can make JES3 bypass program execution so that the job’s 

JCL can be checked. Another //*PROCESS statement can make JES3 bypass output 

processing; then the operator can check by inquiry command whether the job reached ‘ 
execution. a 


Syntax: 


//*PROCESS dsp 
[parameter[,parameter]... 


The //*PROCESS statement consists of the characters //* in columns 1 through 3, PROCESS 
in columns 4 through 10, a blank in column 11, and the DSP name beginning in column 12. J 
The rest of the columns must be blank. 


If the requested DSP requires parameters, code them on the following statement. The 
parameter statement consists of parameters in columns | through 72, separated by commas. 
Columns 73 through 80 must be blank. Only one parameter statement after a //*-PROCESS 
statement is allowed, any others are ignored by JES3. 


Parameter Definition 


dsp 
Identifies the DSP that JES3 is to use in processing the job. Figure 22-1 lists the valid 
DSP names and whether parameters can follow. 
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[SP | DSP Function 


Standard processing functions: 


CI 


MAIN 
OUTSERV 
PURGE 


JES3 Converter/Interpreter Service, which 
interprets the JCL and creates control blocks. 


Main Service, which processes the program. 
Output Service, which processes the job’s output. 
Purge Service, which purges the job. This is 


the last function in any job. JES3 automatically 
creates this DSP. 


Nonstandard processing functions: 


CBPRNT 
DISPDJC 
DISPLAY 
DJCPROC 


DR 
ISDRVR 


JESNEWS 


XXX 


Figure 22-1. 


Location in the JCL 


Control Block Print 
Display Dependent Job Control 
Display Job Queues 


Invoke Dependent Job Control Updating 
Note: A //*PROCESS DJCPROC statement is required 
only when a //*PROCESS MAIN statement is not coded. 


Disk Reader 


Input Service Driver (JES3 Control 
Statement Processing) 


Use JESNEWS Facility 


User-written DSP 


DSPs for JES3 //*PROCESS Statements 


Yes (See JES3 Diagnosis) 


Yes (See JES3 Diagnosis) 
Yes (See JES3 Diagnosis) 
Yes (See JES3 Diagnosis) 


No 


Yes (See JES3 Commands) 


Yes (Qualified ddname of input 
data set) 


Yes (See JES3 Commands) 


(See SPL: JES3 User Modifications and 
Macros) 


e@ Place all //*PROCESS statements for a job immediately after the JOB statement and before 
the first EXEC statement. If the job includes a //*NET statement, the //* NET statement 
must appear between the JOB statement and the first //*PROCESS statement. 


e The //*PROCESS statements can be separated only by their parameter statements. 


e@ JES3 processes the //*PROCESS statements in the order in which they appear in the input 


stream. 


e The first //*PROCESS statement must request an interpreter DSP if you want input service 
error messages, which indicate that a job is to be scheduled for interpreter processing before 
being purged. 


Chapter 22. JES3 Control Statements 22-51 


JES3: //*PROCESS 


Examples of the //* PROCESS Statement 


//EXAM1 JOB 
//*PROCESS CI 
//*PROCESS MAIN 
//*PROCESS OUTSERV 
//S1 EXEC PGM=ANY 


JCL statements 


This example shows how to submit a simple job via //*PROCESS statements. It is processed 
like a standard job. The four standard scheduler functions are used for the job: CI, MAIN, 
OUTSERV, and PURGE. Note that PURGE is not specified; JES3 automatically creates this 
DSP. 


//EXAM2 JOB ) 
//*PROCESS CI 


//*PROCESS MAIN 
//*PROCESS OUTSERV 
//*®PROCESS PLOT 


/ /*ENDPROCESS 
//S1l EXEC PGM=ANY 


//DD1 DD 


JCL statements 


This example shows how to request a user-written DSP: PLOT. PLOT is to be executed after 
output service has completed. Note that PURGE is again not specified but is automatically 
created. 


//EXAM3 JOB 

//*PROCESS OUTSERV 

//*FORMAT  PR,DDNAME=S1.DS1,COPIES=5 
//*DATASET DDNAME=S1.DS1 


data 


/ /*ENDDATASET 
//S81 EXEC PGM=ANY 
//DS1 DD DSNAME=DATA1 


This example uses JES3 output service and the //*DATASET statement. Five copies of data set 
DS1 are printed on any local printer. 
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//*ROUTE XEQ Statement 


Purpose: Use the //*ROUTE XEQ statement to send the following input stream to a network 
node where the job is then executed. JES3 stops transmitting input stream records when it finds 
one of the following: 


The second JOB statement after the //*ROUTE XEQ statement. 
The input stream runs out of card images. 


Note: All output from the job is assumed to print/punch at the originating node unless 
otherwise specified on a DEST parameter. 


Syntax: 


//*ROUTE XEQ nodename[.vmguestid] 


The //*ROUTE XEQ statement consists of the characters //* in columns 1 through 3, 


ROUTE in columns 4 through 8, a blank in column 9, and, starting in any column from 10 
through 72: XEQ, followed by at least one blank and then parameters. JES3 ignores 
columns 73 through 80. 


Do not imbed blanks in the nodename or vmguestid parameters. 


Parameter Definition 


nodename 


Indicates the node. The nodename identifies an MVS JES2 system, an MVS JES3 
(global) system, a VSE POWER node, or a VM system. 


If nodename specifies a local node: 


@ The job executes locally if the job begins with a JOB statement. 
e The job is terminated if the job begins with an NJE statement. 


.Vmguestid 


Identifies a guest system running in a virtual machine (VM), for example, an MVS system 
running under VM. 


Note: Do not specify a work station or terminal in this parameter. 


Location in the JCL 


Place the //*ROUTE XEQ statement after a JOB statement that is valid for the submitting 
location and any //*NETACCT statements. 


Place the //*“ROUTE XEQ statement immediately before a JOB statement that is valid for 
the executing location. 
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JOB Statement after //*ROUTE XEQ 


An error in the //*ROUTE XEQ statement can cause the JOB statement following the 
//*ROUTE XEQ to be processed at the submitting node. To prevent this, code NJB instead of 
JOB on the second JOB statement; JES3 changes the NJB to JOB before transmitting the job. 


Note: TSO users must code NJBinstead of JOB on the second JOB statement. 


Example of the //*ROUTE XEQ Statement 


/ /JOBN1 JOB options ... 
//*ROUTE XEQ 2 

/ /JOBN2 JOB options .. 
//STEP1 EXEC PGM=REPORTER 


//DD1 DD SYSOUT=A, DEST=N1R33 
/ /DD2 DD SYSOUT=A , DEST=N2R33 
//DD3 DD SYSOUT=B , DEST=R33 
/ /DDIN DD * 

data 
/* 


In this example, JOB statement JOBN1 is entered through the JES3 system at node 1. The 

//*ROUTE XEQ statement tells JES3 to send the following input stream to node 2. 

Transmission of the input stream is stopped by the /* delimiter statement. JOB statement 

JOBN2 and all following statements until the delimiter are read and executed by the system at J 
node 2. 


The sysout data sets are sent to two work stations: 
e Sysout data set DD1 is produced at work station 33 attached to node 1. 
e Sysout data set DD2 is produced at work station 33 attached to node 2. 


e Sysout data set DD3 is produced at work station 33 attached to node 1. Because no node 
is specified, the originating node is assumed. il 


Work Work 
Station 33 Station 33 
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[*SIGNOFF Statement 


Purpose: Use the /*SIGNOFF statement to tell JES3 to end a remote job stream processing 
session. At the completion of the current print and/or punch streams, JES3 disconnects the 
remote work station from the system. If JES3 is reading jobs from the station when the output 
completes, JES3 disconnects the station when the input is completed. 


Both systems network architecture (SNA) and binary synchronous communication (BSC) 
remote work stations use the /*SIGNOFF statement. 


References: For more information on the /*SIGNOFF command, see SPL: JES3 Initialization 
and Tuning. 


Syntax: 


/* SIGNOFF 


The /*SIGNOFF statement consists of the characters /* in columns | and 2, SIGNOFF in 
columns 3 through 9, and blanks in columns 10 through 80. 


Note that, unlike other JES3 statements, this statement starts with only one slash. 


Location in the JCL 


The /*SIGNOFF statement can appear anywhere in a local input stream or an input stream 
from a SNA or BSC remote work station. 


Example of the /*SIGNOFF Statement 


/* SIGNOFF 


This statement requests that JES3 terminate a remote job stream processing session. 
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[*SIGNON Statement 


Purpose: Use the /*SIGNON statement to tell JES3 to begin a remote job stream processing 
session. The /*SIGNON statement can override the remote identification number normally 
assigned to the remote work station. This statement is optional for all work stations except 
non-multi-leaving remote stations on a switched line. 


Systems network architecture (SNA) remote work stations must use the LOGON command 
instead of the /*SIGNON statement to notify JES3 of a connection request. 


Syntax: 


/*SIGNON work-station-name {A|(blank)} {R| (blank)} passwdl passwd2 


The /*SIGNON statement consists of the following: 


Contents 


* 


SIGNON 

blanks 

work-station-name, beginning in 16 
blank 

A or a blank 

R or a blank 

blank 

password], beginning in 25 
blanks 

password2, beginning in 35 
blanks 


Note that, unlike other JES3 statements, this statement starts with only one slash. 


Parameter Definition 


work-station-name 
Specifies the name of the remote work station. The work-station-name is 1 through 5 
characters and must have been defined on a JES3 RJPTERM initialization statement. 


Indicates an automatic reader. A can be coded only when the work station is a 
programmable terminal. Leave this column blank if you do not want to specify an 
automatic reader. 


Indicates that print or punch output will be rescheduled if the needed device is not ready. 
R can be coded only when the work station is a nonprogrammable terminal. Leave this 
column blank if you do not want to specify the R option. 


password! 


Specifies the password for the remote job processing (RJP) line. password! is 1 through 8 
characters and must have been defined on a JES3 RJPLINE initialization statement. 
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password2 


Specifies the password for the work station. password2 is 1 through 8 characters and 
must have been defined on a JES3 RJPTERM initialization statement. 


Location in the JCL 


Place the /*SIGNON statement at the start of an input stream to be transmitted from a remote 
work station. 


Example of the /*SIGNON Statement 


/*SIGNON QUIN A  PSWD1 PSWD2 


This statement requests that remote work station QUIN begin a remote job stream processing 
session. The value A in column 22 specifies an automatic reader for the programmable 
terminal. PSWD1, beginning in column 25, is the password assigned to a dial line. PSWD2, 
beginning in column 35, is the password assigned to the remote work station. 
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Index 


’ (apostrophe) 
use of to enclose special characters 4-5 
use of with special characters 4-5 
when not needed to enclose special characters 4-5 


period. (double period) 
in syntax 4-3 

. (period) 
in syntax 4-2 

... (ellipsis) 
in syntax 4-3 


( 


() (parentheses) 
in syntax 4-2 


| (logical or) 
in syntax 4-2 


& 


& (ampersand) 
in syntax 4-2 
&&dsname 
subparameter of DD DSNAME parameter 10-84 


‘ 


{ } (braces) 
in syntax 4-2 


* (asterisk) 
as code parameter of JES2 /*OUTPUT 
statement 21-15 

DD statement parameter 10-13 
defaults 10-13 
examples 10-14 
locationin JCL 10-14 
relationship to other control statements 10-14 
relationship to other parameters 10-13 
unread records 10-14 

description 10-13 


in syntax 4-2 
relationship to DD DATA parameter 10-39 
subparameter of /*JOBPARM SYSAFF 
parameter 21-7 
subparameter of DD SYSOUT parameter 10-162 
subparameter of JOB RESTART parameter 15-35 
subparameter of OUTPUT JCL CLASS 
parameter 17-17 
* ddname 
description 10-61 
explained 4-6 
subparameter of DD DCB parameter 10-46 
subparameter of DD DSNAME parameter 10-84 
subparameter of DD REFDD parameter 10-143 
subparameter of VOLUME= REF 
subparameter 10-181 
* label 
in DD CNTL parameter 10-33 
* name 
explained 4-6 
subparameter of DD OUTPUT parameter 10-129 
* procstepname.ddname 
explained 4-6 
subparameter of VOLUME= REF 
subparameter 10-181 
* stepname.ddname 
description 10-61 
subparameter of DD DCB parameter 10-46 
subparameter of DD DSNAME parameter 10-84 
subparameter of DD REFDD parameter 10-143 
subparameter of EXEC PGM parameter 14-23 
subparameter of VOLUME= REF 
subparameter 10-181 
* stepname.label 
in DD CNTL parameter 10-33 
* stepname.name 
explained 4-6 
subparameter of DD OUTPUT parameter 10-129 
* stepname.procstepname.ddname 
description 10-61 
explained 4-6 
subparameter of DD DCB parameter 10-46 
subparameter of DD DSNAME parameter 10-84 
subparameter of DD REFDD parameter 10-143 
subparameter of EXEC PGM parameter 14-23 
subparameter of VOLUME= REF 
subparameter 10-181 
* stepname.procstepname. label 
in DD CNTL parameter 10-33 
* stepname.procstepname.name 
explained 4-6 
subparameter of DD OUTPUT parameter 10-129 


[ 


[] (brackets) 
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in syntax 4-2 


/ 


/ (slash) 
in syntax 4-2 
subparameter of //*MAIN FETCH 
parameter 22-31 
subparameter of //*MAIN SETUP 
parameter 22-36 
subparameter of //*MAIN SYSTEM 
parameter 22-37 
/* (slash asterisk) 
as delimiter statement 12-1 
/*DEL 
statement for submitting jobs to internal 
reader 21-1, 22-1 
with XMIT JCL statement 20-1, 20-8 
/*EOF 
statement for submitting jobs to internal 
reader 21-1, 22-1 
with XMIT JCL statement 20-1, 20-8 
/*JOBPARM 
JES2 control statement 21-4 
description 21-4 
example 21-9 
location in JCL 21-8 
overrides 21-8 
parameters 21-5 
/*MESSAGE 
JES2 control statement 21-10 
description 21-10 
example 21-10 
location in JCL 21-10 
relationship to /*“ROUTE XEQ 
statement 21-10 
/*NETACCT 
JES2 control statement 21-1] 
default 21-11 
description 21-11 
example 21-11 
location in JCL 21-11 
overrides 21-11 
parameter 21-11 
/*NOTIFY 
JES2 control statement 21-12 
description 21-12 
examples 21-13 
location inJCL 21-13 
overrides 21-13 
parameters 21-12 


relationship to other control statements 


/*OUTPUT 
JES2 control statement 21-14 
description 21-14 
example 21-22 
location in JCL 21-22 
overrides 21-22 
parameters 21-15 
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relationship to other control statements 


/*PRIORITY 
JES2 control statement 21-23 
description 21-23 
example 21-24 
location in JCL 21-24 
overrides 21-23 
parameter 21-23 


relationship to other control statements 


/*PURGE 
statement for submitting jobs to internal 
reader 21-1 
/*ROUTE 


/*ROUTE PRINT 
description 21-25 

/*ROUTE PUNCH 
description 21-25 

/*ROUTE XEQ 
description 21-25 


relationship to /*MESSAGE statement 


JES2 control statement 21-25 
description 21-25 
examples 21-28 
location in JCL 21-27 
multiple statements 21-27 
parameters 21-25 
processing of 21-27 


/*SCAN 
statement for submitting jobs to internal 
reader 21-1 
/*SETUP 


JES2 control statement 21-29 
description 21-29 
example 21-29 
location in JCL 21-29 
parameters 21-29 

/*SIGNOFF 

JES2 control statement 21-30 
description 21-30 
example 21-30 
location in JCL 21-30 

JES3 control statement 22-55 
description 22-55 
example 22-55 
location in JCL 22-55 

/*SIGNON 

JES2 control statement 21-31 
description 21-31 
examples 21-32 
location in JCL 21-32 
parameters 21-31 

JES3 control statement 22-56 
description 22-56 
example 22-57 
location in JCL 22-57 
parameters 22-56 

/*XEQ 

JES2 control statement 21-33 
description 21-33 
example 21-34 


location in JCL 21-33 
multiple statements 21-33 
parameters 21-33 
/*XMIT 
JES2 control statement 21-35 
defaults 21-36 
description 21-35 
examples 21-37 
location in JCL 21-36 
parameter 21-35 
//* DATASET 
JES3 control statement 22-5 
description 22-5 
examples 22-7 
location inJCL 22-6 
parameters 22-5 
//*ENDDATASET 
JES3 control statement 22-8 
description 22-8 
example 22-8 
location in JCL 22-8 
//*ENDPROCESS 
JES3 control statement 22-9 
description 22-9 
example 22-9 
location in JCL 22-9 
//*FORMAT PR 
JES3 control statement 22-10 
description 22-10 
examples 22-19 
location in JCL 22-19 
parameters 22-11 
relationship to //*PROCESS statement 22-19 
relationship to sysout DD and OUTPUT JCL 
statements 22-19 
//*FORMAT PU 
JES3 control statement 22-20 
description 22-20 
example 22-24 
location in JCL 22-24 
parameters 22-21 
relationship to //*PROCESS statement 22-24 
relationship to sysout DD and OUTPUT JCL 
statements 22-24 
//*MAIN 
JES3 control statement 22-25 
description 22-25 
examples 22-40 
location in JCL 22-40 
parameters 22-27 
//*NET 
JES3 control statement 22-41 
description 22-41 
examples 22-45 
location in JCL 22-45 
parameter 22-42 
//*NETACCT 
JES3 control statement 22-46 
defaults 22-47 
description 22-46 
location in JCL 22-47 


parameters 22-46 
//*QPERATOR 
JES3 control statement 22-48 
description 22-48 
example 22-48 
location in JCL 22-48 
//*PAUSE 
JES3 control statement 22-49 
description 22-49 
example 22-49 
location in JCL 22-49 
//*PROCESS 
end of 22-9 
JES3 control statement 22-50 
description 22-50 
examples 22-52 
location in JCL 22-51 
parameter 22-50 
//*ROUTE XEQ 
JES3 control statement 22-53 
description 22-53 
example 22-54 
location in JCL 22-53 
parameters 22-53 


b 


, (comma) 
in syntax 4-2 
use of in parameter field 3-3 
when coded in brackets or braces 4-3 


= (equal sign) 
in syntax 4-2 


parameter of JES3 /*SIGNON statement 22-56 


subparameter of DCB BFTEK subparameter 10-49 
subparameter of DCB OPTCD subparameter 10-54 


subparameter of DCB PCI subparameter 10-56 
subparameter of DD RECFM parameter 10-136 
subparameter of RECFM parameter 10-137, 
10-138 
AB 
ABNORMAL parameter of JES3 //*NET 
statement 22-41 
ABCMP 
parameter of JES3 //*NET statement 22-42 
ABE 


subparameter of DCB EROPT subparameter 10-52 


ABNORMAL 
parameter of JES3 //*NET statement 22-42 
abnormal termination 
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See termination, abnormal 
ABSTR 
subparameter of DD SPACE parameter 10-153 
AC 
ABCMP parameter of JES3 //*NET 
statement 22-41 
ACB (access method control block) 10-18 
ACC 
subparameter of DCB EROPT subparameter 10-52 
access method 
See also individual access methods 
for dummy data sets 10-87 
access method control block (ACB) 10-18 
access-code 
subparameter of DD ACCODE parameter 10-16 
ACCODE 
DD statement parameter 10-16 
defaults 10-16 
description 10-16 
example 10-17 
overrides 10-17 
subparameters 10-16 
account-number 
subparameter of JOB accounting information 
parameter 15-6 
accounting-information 
JOB statement parameter 15-5 
description 15-5 
examples 15-8 
JES2 format 15-6 
JES2 processing of invalid subparameters 15-7 
overrides of subparameters in JES2 
format 15-7 
relationship to other control statements 15-6 
subparameters 15-6 
subparameters for JES2 format 15-6 
specified on JES3 //*NETACCT statement 22-46 
subparameter of EXEC ACCT parameter 14-6 
subparameter of JOB accounting information 
parameter 15-6 
ACCT 
EXEC statement parameter 14-5 
description 14-5 
examples 14-6 
subparameter 14-6 
parameter of JES3 //*NETACCT statement 22-46 
ACMAIN 
parameter of JES3 //-MAIN statement 22-27 
ACS (automatic class selection) routine 
with DD DATACLAS parameter 10-43 
with DD MGMTCLAS parameter 10-120 
with DD STORCLAS parameter 10-157 
address 
subparameter of //FNETACCT BLDG 
parameter 22-46 
subparameter of DD SPACE parameter 10-154 
ADDRSPC 
EXEC statement parameter 14-7 
default 14-7 
description 14-7 
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examples 14-8 
overrides 14-7 
relationship to REGION parameter 14-7 
subparameters 14-7 
JOB statement parameter 15-9 
default 15-9 
description 15-9 
examples 15-10 
overrides 15-9 
relationship to REGION parameter 15-9 
subparameters 15-9 
AFF 
subparameter of DD UNIT parameter 10-176 
affinity 
See unit affinity 
AL 
subparameter of DD LABEL parameter 10-110 
ALIGN 
subparameter of DD FCB parameter 10-93 
alignment, of printing forms 
specifying 10-93 
ALL 
subparameter of //FMAIN FETCH 
parameter 22-31 
subparameter of OUTPUT JCL JESDS 
parameter 17-44 
allocation attributes 
specifying on DD LIKE parameter 10-115 
specifying on DD REFDD parameter 10-143 
allocation, of data sets 
for MSS when MSVGP omitted 10-124 
holding for reuse 14-17 
allocation, of devices 
from groups 10-174 
number of 10-174 
when unit affinity is specified 10-176 
ALX 
subparameter of DD SPACE parameter 10-153 
AMORG 
subparameter of DD AMP parameter 10-19 
AMP 
DD statement parameter 10-18 
description 10-18 
examples 10-23 
relationship to other parameters 10-22 
subparameters 10-19 
with DSNAME parameter 10-85 
AN 
character set for 1403 10-171, 17-63 
character set for 3203 Model 5 10-171, 17-63 
ANY 
subparameter of /*JOBPARM SYSAFF 
parameter 21-7 
subparameter of //FMAIN SYSTEM 
parameter 22-37 
subparameter of //*MAIN TYPE parameter 22-39 
subparameter of //* NET DEVPOOL 
parameter 22-43 
ANYLOCAL 


subparameter of //*FORMAT DEST 
parameter 22-15, 22-22 
subparameter of DD DEST parameter 10-64 
subparameter of OUTPUT JCL DEST 
parameter 17-31 
area 7 
subparameter of DD DSNAME parameter 10-83, 
10-84 
asterisk 
See * (asterisk) 
attributes, data set 
specifying on DD LIKE parameter 10-115 
specifying on DD REFDD parameter 10-143 
specifying with DD DATACLAS parameter 10-42 
specifying with DD DCB parameter 10-44 
AUL 
subparameter of DD LABEL parameter 10-110 
automatic cartridge loader 
on THWSSEP subparameter of //*MAIN 
statement 22-38 
automatic class selection (ACS) routine 
See ACS (automatic class selection) routine 
average record length 
specifying in the DD SPACE parameter 10-150 
AVGREC 
DD statement parameter 10-24 
description 10-24 
example 10-25 
overrides 10-24 
relationship to other parameters 10-25 
subparameters 10-24 
with DD SPACE reclgth subparameter 10-150 
All 
character set for 3211 10-171, 17-63 


B 


B 


subparameter of DCB OPTCD subparameter 10-55 


subparameter of RECFM parameter 10-137, 
10-138, 10-139 
backward references 
See references 
base control program 
See BCP (base control program) 
basic direct access method 
See BDAM (basic direct access method) 
basic indexed sequential access method 
See BISAM (basic indexed sequential access 
method) 
basic partitioned access method 
See BPAM (basic partitioned access method) 
basic sequential access method 
See BSAM (basic sequential access method) 
basic telecommunications access method 
See BTAM (basic telecommunications access 
method) 
BCP (base control program) 
in relation to JCL statements 2-1 
BDAM (basic direct access method) 


subparameters of DD DCB parameter 10-49 
BFALN 
subparameter of DD DCB parameter 10-49 
BFTEK 
subparameter of DD DCB parameter 10-49 
BISAM (basic indexed sequential access method) 
subparameters of DD DCB parameter 10-49 
blanks 
use of in parameters 4-5 
BLDG 
parameter of JES3 //*NETACCT statement 22-46 
BLKCHAR 
subparameter of OUTPUT JCL DATACK 
parameter 17-25 
blklgth 
subparameter of DD SPACE parameter 10-150 
BLKPOS 
subparameter of OUTPUT JCL DATACK 
parameter 17-25 
BLKSIZE 
coded with DATA parameter 10-39 
subparameter of DD DCB parameter 10-49 
BLOCK 
subparameter of OUTPUT JCL DATACK 
parameter 17-25 
block length 
specifying in the DD SPACE parameter 10-150 
block size 
See BLKSIZE 
blocks 
subparameter of DCB LIMCT subparameter 10-53 
BLP 
subparameter of DD LABEL parameter 10-110 
BPAM (basic partitioned access method) 
subparameters of DD DCB parameter 10-49 
BS 
subparameter of RECFM parameter 10-138 
BSAM (basic sequential access method) 
subparameters of DD DCB parameter 10-49 
with DD CHKPT parameter 10-31 
BST 
subparameter of RECFM parameter 10-138 
BT 
subparameter of RECFM parameter 10-137, 
10-138 
BTAM (basic telecommunications access method) 
subparameters of DD DCB parameter 10-49 
buffer, forms control (FCB) 
See FCB 
buffers 
requirements with DD AMP parameter 10-22 
subparameter of DCB BUFIN parameter 10-49 
subparameter of DCB BUFMAX 
subparameter 10-50 
subparameter of DCB BUFNO 
subparameter 10-50 
subparameter of DCB BUFOUT 
subparameter 10-50 
BUFIN 
subparameter of DD DCB parameter 10-49 
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BUFL 
subparameter of DD DCB parameter 10-49 
BUFMAX 
subparameter of DD DCB parameter 10-50 
BUFND 
subparameter of DD AMP parameter 10-19 
BUFNI 
subparameter of DD AMP parameter 10-19 
BUFNO 
coded with DATA parameter 10-39 
subparameter of DD DCB parameter 10-50 
BUFOFF 
subparameter of DD DCB parameter 10-50 
BUFOUT 
subparameter of DD DCB parameter 10-50 
BUFSIZE 
subparameter of DD DCB parameter 10-50 
BUFSP 
subparameter of DD AMP parameter 10-19 
BURST 
DD statement parameter 10-26 
defaults 10-26 
description 10-26 
example 10-27 
overrides 10-26 


relationship to other control statements 10-27 


relationship to other parameters 10-27 
subparameters 10-26 
OUTPUT JCL statement parameter 17-9 
defaults 17-9 
description 17-9 
example 17-10 
overrides 17-9 
subparameters 17-9 


parameter of JES2 /*JOBPARM statement 21-5 
parameter of JES2 /“OUTPUT statement 21-16 


burster-trimmer-stacker 
See BURST 
BYTES 


parameter of JES2 /“JOBPARM statement 21-5 


parameter of JES3 //*MAIN statement 22-27 
bytes 


subparameter of AMP BUFSP parameter 10-19 


subparameter of DCB BLKSIZE 
subparameter 10-49 


subparameter of DCB BUFL subparameter 10-49 


subparameter of DCB BUFSIZE 
subparameter 10-50 

subparameter of DCB KEYLEN 
subparameter 10-53 

subparameter of DCB LRECL subparameter 

subparameter of DCB RESERVE 
subparameter 10-57 


subparameter of DD KEYLEN parameter 10-104 
subparameter of DD LRECL parameter 10-117 
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subparameter of //* DATASET DDNAME 
parameter 22-5 

subparameter of //*FORMAT STACKER 
parameter 22-18 

subparameter of //*MAIN BYTES 
parameter 22-27 

subparameter of //*MAIN CARDS 
parameter 22-28 

subparameter of //*MAIN LINES parameter 

subparameter of //*MAIN PAGES 
parameter 22-34 

subparameter of DCB MODE subparameter 

subparameter of DCB OPTCD 
subparameter 10-54, 10-55, 10-56 

subparameter of DCB TRTCH 
subparameter 10-58 

CANCEL 

subparameter of //*MAIN BYTES 
parameter 22-27 

subparameter of //*MAIN CARDS 
parameter 22-28 

subparameter of //*MAIN FAILURE 
parameter 22-31 

subparameter of //*MAIN LINES parameter 

subparameter of //*MAIN PAGES 
parameter 22-34 

CARDS 


22-32 


10-53 


22-32 


parameter of JES2 /*JOBPARM statement 21-5 


parameter of JES3 //*MAIN statement 22-28 
cards 
JES2 format subparameter of JOB accounting 
information 15-7 
CARRIAGE 
parameter of JES3 //*FORMAT PR 
statement 22-12 
carriage control character 
specifying 17-21 
carriage-tape-name 
subparameter of //*FORMAT CARRIAGE 
parameter 22-12 
catalog 
private or user 
specifying for job 11-2 
specifying for step 11-8 
cataloged procedures 


See procedures, cataloged and in-stream 
CATLG 


subparameter of DD DISP parameter 10-69, 10-70 


cccc 
subparameter of /*JOBPARM SYSAFF 
parameter 21-7 
character set 
chart of 4-4 
special character set 
specifying 10-171, 17-63 
use of in parameters 4-5 
use of in syntax 4-4 
using 10-172, 17-63 
universal character set (UCS) 
specification of 10-170, 17-62 


use of in statements 4-4 
character-arrangement table 
specifying on DD CHARS parameter 10-28 
specifying on OUTPUT JCL CHARS 
parameter 17-11 
character-set-code 
subparameter of DD UCS parameter 10-170 
subparameter of OUTPUT JCL UCS 
parameter 17-62 
CHARS 
affect of DD MODIFY parameter 10-121 
affect of OUTPUT JCL MODIFY 
parameter 17-50 
affect of OUTPUT JCL TRC parameter 17-60 
DD statement parameter 10-28 
defaults 10-29 
description 10-28 
examples 10-30 
overrides 10-29 
printer reassignment 10-30 
relationship to other control statements 10-30 
relationship to other parameters 10-29 
subparameters 10-28 
OUTPUT JCL statement parameter 17-11 
defaults 17-12 
description 17-11 
example 17-13 
overrides 17-12 
subparameters 17-11 
parameter of JES2 /“OUTPUT statement 21-16 
parameter of JES3 //*FORMAT PR 
statement 22-13 
checkid 
subparameter of JOB RESTART parameter 15-35 
checkpoint data set 
See data set, checkpoint 
checkpoints 
allowing and suppressing 14-26, 15-30 
logical page size for 17-14 
of data sets 11-21 
of programs 11-18 
restarting from 15-35 
written after specified number of logical 
pages 17-15 
written after specified number of seconds 17-16 
CHKPT 
DD statement parameter 10-31 
description 10-31 
examples 10-32 
for concatenated data sets 10-32 
overrides 10-31 
relationship to other parameters 10-31 
relationship to SYSCKEOV DD 
Statement 10-31 
subparameter 10-31 
relationship to SYSCKEOV DD statement 11-21 
CHNSIZE 
parameter of JES3 //*FORMAT PR 
statement 22-13 
parameter of JES3 //*FORMAT PU 
statement 22-21 


CKPTLINE 
OUTPUT JCL statement parameter 17-14 
defaults 17-14 
description 17-14 
example 17-14 
CKPTLNS 
parameter of JES2 /“OUTPUT statement 21-16 
CKPTPAGE 
OUTPUT JCL statement parameter 17-15 
defaults 17-15 
description 17-15 
example 17-15 
relationship to other parameters 17-15 
subparameter 17-15 
CKPTPGS 
parameter of JES2 /*OUTPUT statement 21-16 
CKPTSEC 
OUTPUT JCL statement parameter 17-16 
defaults 17-16 
description 17-16 
example 17-16 
relationship to other parameters 17-16 
subparameter 17-16 
CLASS 
JOB statement parameter 15-11 
defaults 15-11 
description 15-11 
example 15-12 
overrides 15-11 
relationship to other control statements 15-12 
subparameter 15-11 
OUTPUT JCL statement parameter 17-17 
description 17-17 
examples 17-19 
overrides 17-17 
subparameters 17-17 
parameter of JES3 //*DATASET statement 22-6 
parameter of JES3 //*MAIN statement 22-29 
class 
subparameter of //*DATASET DDNAME 
parameter 22-6 
subparameter of DD SYSOUT parameter 10-162 
subparameter of JOB MSGCLASS 
parameter 15-17 
subparameter of OUTPUT JCL CLASS 
parameter 17-17 
class-name 
subparameter of //*MAIN CLASS 
parameter 22-29 
class, job 
assigning 15-11 
class, output 
assigning job log to 15-17 
held (in JES2 system) 
affect on JES2 /*JOBPARM COPIES 
parameter 21-6 
relationship to DD SYSOUT parameter 10-165 
relationship to OUTPUT JCL CLASS 
parameter 17-17 
significance of 10-166, 15-17, 17-18 
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specifying on OUTPUT JCL statement 17-17 
specifying on sysout DD statement 10-161 
CLOSE 
macro instruction 
with DD SPACE parameter 10-153 
with the DD FREE parameter 10-100 
subparameter of DD FREE parameter 10-99 
CNTL 
DD statement parameter 10-33 
description 10-33 
examples 10-33 
subparameters 10-33 
JCL statement 9-1 
comments field 9-2 
description 9-1 
example 9-2 
label field 9-1 
location in JCL 9-2 
operation field 9-1 
parameter field 9-2 
code 


parameter of JES2 /*OUTPUT statement 21-15 
subparameter of EXEC COND parameter 14-10 
subparameter of JOB COND parameter 15-13 


code-name 


subparameter of DD SYSOUT parameter 10-163 


Command 
JCL statement 7-1 
comments field 7-2 
description 7-1 
example 7-2 
location in JCL 7-2 
operation field 7-2 
parameter field 7-2 
JES2 statement 21-2 
description 21-2 
examples 21-3 
location in JCL 21-3 
operand 21-2 
parameters 21-2 
JES3 statement 22-3 
description 22-3 
examples 22-4 
location in JCL 22-4 
operand 22-3 
parameters 22-3 
command-verb 
parameter of JES2 command statement 21-2 
parameter of JES3 command statement 22-3 
Comment 
JCL statement 8-1 
description 8-1 
examples 8-1 
in listings 8-1 
location inJCL 8-1 
relationship to MSGLEVEL parameter 8-1 
COMPACT 
OUTPUT JCL statement parameter 17-20 
defaults 17-20 
description 17-20 
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example 17-20 
overrides 17-20 
subparameter 17-20 


parameter of JES2 /*OUTPUT statement 21-16 


parameter of JES3 //*FORMAT PR 
statement 22-14 
parameter of JES3 //*FORMAT PU 
statement 22-22 
compaction table 
specifying 17-20 
compaction-table-name 
subparameter of //*FORMAT COMPACT 
parameter 22-14, 22-22 
subparameter of OUTPUT JCL COMPACT 
parameter 17-20 
concatenation, of data sets 
block sizes for 10-11 
checkpointing of 10-32 
coding concatenations 10-11 
description 10-11 
devices for 10-11 
logical record lengths for 10-11 
of job catalogs 11-2 
of job libraries 11-5 
of step catalogs 11-8 
of step libraries 11-12 
references to 10-12 
with dummy data sets 10-12, 10-87 
COND 
effect on private job library specification 11-6 
EXEC statement parameter 14-9 
cautions 14-12 
description 14-9 
examples 14-14 
overrides 14-11 
subparameters 14-10 
summary charts 14-13 
JOB statement parameter 15-13 
description 15-13 
examples 15-14 
overrides 15-14 
subparameters 15-13 
summary chart 15-14 
CONTIG 


subparameter of DD SPACE parameter 10-153 


continuing, of statements 
examples 3-6 
of JCL statements 3-5 
of JES2 control statements 3-6 
of JES3 control statements 3-6 
CONTROL 
OUTPUT JCL statement parameter 17-21 
defaults 17-21 
description 17-21 
example 17-21 
subparameters 17-21 
parameter of JES3 //*FORMAT PR 
statement 22-14 
converter/interpreter service 
in job processing 22-50 


COPIES 
DD statement parameter 10-35 
defaults 10-36 
description 10-35 
examples 10-38 
overrides 10-36 
relationship to other control statements 10-37 
relationship to other parameters 10-36 
relationship to OUTPUT JCL COPIES 
parameter 10-37 
subparameters 10-35 
OUTPUT JCL statement parameter 17-22 
defaults 17-23 
description 17-22 
examples 17-24 
overrides 17-23 
relationship to other control statements 17-23 
relationship to other parameters 17-23 
subparameters 17-22 
parameter of JES2 /*JOBPARM statement 21-5 
parameter of JES2 /*OUTPUT statement 21-16 
parameter of JES3 //*FORMAT PR 
statement 22-14 
parameter of JES3 //*FORMAT PU 
statement 22-22 
relationship to DD FLASH parameter 10-97 
copies 
JES2 format subparameter of JOB accounting 
information 15-7 
COPY 
subparameter of JOB TYPRUN parameter 15-41 
copy-modification module 
See modification, of printed output 
COPYG 
parameter of JES2 /*OUTPUT statement 21-17 
copying job stream to sysout 
specifying 15-41 
count 
subparameter of /*OUTPUT FLASH 
parameter 21-19 
subparameter of /*OUTPUT FLASHC 
parameter 21-20 
subparameter of //*FORMAT FLASH 
parameter 22-16 
subparameter of DD FLASH parameter 10-96 
subparameter of OUTPUT JCL FLASH 
parameter 17-35 
CPRI 
subparameter of DD DCB parameter 10-50 
CROPS 
subparameter of DD AMP parameter 10-20 
CX 
subparameter of DCB DSORG 
subparameter 10-51 
cycle 
subparameter of //*MAIN DEADLINE 
parameter 22-29 
CYL 
subparameter of DD SPACE parameter 10-150 
cylinders 
specifying in DD SPACE parameter 10-150 


CYLOFL 
subparameter of DD DCB parameter 10-50 


subparameter of //*MAIN BYTES 
parameter 22-27 
subparameter of //*MAIN CARDS 
parameter 22-28 
subparameter of //*MAIN LINES parameter 22-32 
subparameter of //*MAIN PAGES 
parameter 22-34 
subparameter of //*NET ABNORMAL 
parameter 22-42 
subparameter of //*NET NORMAL 
parameter 22-42 
subparameter of DCB BFALN subparameter 10-49 
subparameter of DCB BFTEK subparameter 10-49 
subparameter of DCB FUNC subparameter 10-52 
subparameter of RECFM parameter 10-138 
DA 
subparameter of DCB DSORG 
subparameter 10-51 
DATA 
DD statement parameter 10-39 
defaults 10-39 
examples 10-40 
location in JCL 10-40 
relationship to other control statements 10-40 
relationship to other parameters 10-39 
unread records 10-40 
description 10-39 
data class 
See DATACLAS 
data control block 
See DCB 
data definition 
See DD 
data set 
See also sysout 
attributes 
specifying on DD LIKE parameter 10-115 
specifying on DD REFDD parameter 10-143 
specifying with DD DATACLAS 
parameter 10-42 
specifying with DD DCB parameter 10-44 
backup 10-119 
checkpoint 
for checkpointing data sets 11-21 
for checkpointing programs 11-18 
in generation group 
in restarted jobs 15-36 
labels for 10-110 
naming 10-83 
indexed sequential 
naming 10-83, 10-84 
migration 10-119 
multivolume 
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referenced in VOLUME= REF 
subparameter 10-182 
specifying volume of 10-180 
organization (DSORG) 10-51 
partitioned (PDS) 
naming 10-83, 10-84 
passed 
unit count for 10-175 
permanent 
naming 10-83 
requesting resources for 2-2 
sequence number 
specifying in DD LABEL parameter 10-109 
specifying on DD LIKE parameter 10-115 
system-managed 
sending to other destinations 17-45 
specifying processing of 17-44 
temporary 
naming 10-84 
data-class-name 
subparameter of DD DATACLAS 
parameter 10-42 
data-set-name 
subparameter of DD LIKE parameter 10-115 
data-set-sequence-number 
subparameter of DD LABEL parameter 10-109 
DATACK 
OUTPUT JCL statement parameter 17-25 
defaults 17-26 
description 17-25 
example 17-26 
relationship to other parameters 17-26 
subparameters 17-25 
DATACLAS 
DD statement parameter 10-42 
defaults 10-43 
description 10-42 
examples 10-43 
overrides 10-43 
relationship to other parameters 10-43 
subparameters 10-42 
DATASET JES3 statement 
See //*DATASET 
date 
subparameter of //*MAIN DEADLINE 
parameter 22-29 
DAU 
subparameter of DCB DSORG 
subparameter 10-51 
DCB 
copying attributes from 10-45 
data control block 
completing 10-46 
completing during execution 10-44 
DD statement parameter 10-44 
description 10-44 
examples 10-47 
relationship to other parameters 10-47 
subparameters 10-45, 10-49 
macro instruction 10-44 
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DD 


JCL statement 10-1 
comments field 10-11 
ddname. 10-1 
description 10-1 
examples 10-12 
location in JCL 10-11 
name field 10-1 
operation field 10-3 
parameter field 10-3 

maximum statements per job_ 10-1 

special DD statements 
description 11-1 


DDNAME 


on DD statement 10-59 
description 10-59 
examples 10-61 
location in JCL 10-59 
location of referenced statement 10-60 
overrides 10-59 
parameters not permitted on referenced DD 
statement 10-60 
referenced DD statement 10-60 
relationship to other parameters 10-59 
subparameter 10-59 
parameter of JES3 //*DATASET statement 22-5 
parameter of JES3 //*FORMAT PR 
statement 22-12 
parameter of JES3 //*FORMAT PU 
statement 22-21 


ddname 


examples 10-12 

invalid with DD AMP parameter 10-22 

name field on DD statement 10-1 

reserved for special uses 11-1 

special ddnames_ 10-2 

subparameter of /*JOBPARM PROCLIB 
parameter 21-6 

subparameter of //*MAIN FETCH 
parameter 22-31 

subparameter of DD DDNAME parameter 10-59 

subparameter of DD MSVGP parameter 10-123 


DEADLINE 


parameter of JES3 //*MAIN statement 22-29 


DEFAULT 


OUTPUT JCL statement parameter 17-27 

defaults 17-27 

description 17-27 

example 17-28 

location in JCL 17-27 

references to default OUTPUT JCL 
statements 17-28 

subparameters 17-27 


default 


location of default OUTPUT JCL statements 17-6 
OUTPUT JCL statement 17-5 
specifying statements 17-27 


DEFER 


subparameter of DD UNIT parameter 10-175 


DEL JES2 statement 


See /*DEL 
DELETE 


subparameter of DD DISP parameter 10-69, 10-70 


delimiter 
for JES3 in-stream data sets 22-8 
for transmission of input stream 20-1 
processing when invalid 10-78, 20-6 
subparameter of DD DLM parameter 10-77 


subparameter of XMIT JCL DLM parameter 20-6 


with DD * statement 10-13 
with DD DATA statement 10-39 
with XMIT JCL statement 20-6 
delimiter statement 
JCL statement 12-1 
comments field 12-1 
description 12-1 
examples 12-2 
location in JCL 12-2 
relationship to DLM parameter 12-1 
DEN 
subparameter of DD DCB parameter 10-51 
density, magnetic 
specifying for tape data set 10-51 
DEPT 
parameter of JES3 //*NETACCT statement 22-46 
dept 
subparameter of //*NETACCT DEPT 
parameter 22-46 
DEST 
DD statement parameter 10-63 
defaults 10-65 
description 10-63 
examples 10-66 
overrides 10-65 
relationship to other control statements 10-65 
relationship to other parameters 10-65 
subparameters for JES2 10-63 
subparameters for JES3 10-64 
OUTPUT JCL statement parameter 17-30 
defaults 17-32 
description 17-30 
examples 17-32 
overrides 17-32 
relationship to other parameters 17-32 
subparameter for JES2 17-30 
subparameters for JES3 17-31 
parameter of JES2 /“OUTPUT statement 21-17 
parameter of JES3 //*FORMAT PR 
statement 22-15 
parameter of JES3 //*“FORMAT PU 
Statement 22-22 
XMIT JCL statement parameter 20-5 
description 20-5 
examples 20-5 
subparameters 20-5 
dest-name 
parameter of JES2 /*SIGNON statement 21-32 
destination, for data set 
specifying on OUTPUT JCL statement 10-63, 
17-30 
specifying on XMIT JCL statement 20-5 


device-name 
See also name 
subparameter of //*-FORMAT DEST 
parameter 22-15, 22-22 
subparameter of //* NET DEVPOOL 
parameter 22-43 
subparameter of DD DEST parameter 10-64 
subparameter of OUTPUT JCL DEST 
parameter 17-31 
device-number 
subparameter of //*FORMAT DEST 
parameter 22-15, 22-23 
subparameter of DD DEST parameter 10-64 
subparameter of DD UNIT parameter 10-173 
device-type 
subparameter of DD UNIT parameter 10-174 
devices 
sharing through unit affinity 10-176 
specifying in DD UNIT parameter 10-173 
DEVPOOL 
parameter of JES3 //*NET statement 22-43 
DEVRELSE 
parameter of JES3 //*NET statement 22-43 
DHWS 
subparameter of //*MAIN SETUP 
parameter 22-36 
DIAGNS 
subparameter of DD DCB parameter 10-51 
directory 
subparameter of DD SPACE parameter for system 
assignment 10-152 
discrete profile 
See RACF (Resource Access Control Facility) 
diskette input/output 
See 3540 diskette input/output unit 
DISP 
DD statement parameter 10-67 
defaults 10-71 
description 10-67 
examples 10-76 
relationship to other parameters 10-71 
subparameters 10-67 
dispatching priority 
See priority, dispatching 
disposition, of data sets 
at abnormal termination 
coded in DD DISP parameter 10-70 
at normal termination 
coded in DD DISP parameter 10-69 
DISP= MOD for multivolume data set 10-72 
of Generation Data Sets 10-7] 
of partitioned data sets 10-72 
of QSAM data sets 10-71 
of temporary data sets 10-71 
DLM 
DD statement parameter 10-77 
default 10-78 
description 10-77 
example 10-78 
relationship to other parameters 10-78 
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subparameter 10-77 
parameter of JES2 /*XMIT statement 21-36 
XMIT JCL statement parameter 20-6 
default 20-6 
description 20-6 
example 20-7 
subparameter 20-6 
DOUBLE 
subparameter of //*FORMAT CONTROL 
parameter 22-14 
subparameter of OUTPUT JCL CONTROL 
parameter 17-21 
DPRTY 
EXEC statement parameter 14-15 
defaults 14-16 
description 14-15 
examples 14-16 
relationship to other control statements 14-16 
subparameters 14-15 
DS 
subparameter of //*FORMAT CHNSIZE 
parameter 22-13, 22-21 
DSID 
DD statement parameter 10-79 
description 10-79 
example 10-80 
relationship to other parameters 10-80 
subparameters 10-79 
DSN 
See DSNAME 
DSNAME 
DD statement parameter 10-81 
description 10-81 
examples 10-85 
relationship to other parameters 10-84 
subparameter for dummy data set 10-84 
subparameters 10-82 
subparameters for permanent data set 10-82 
subparameters for temporary data set 10-83 
subparameters when copying data set 
name 10-84 
invalid with DD AMP parameter 10-22 
dsname 
subparameter of //*MAIN UPDATE 
parameter 22-39 
subparameter of DD DCB parameter 10-45 
subparameter of DD DSNAME parameter 10-83 
subparameter of VOLUME= REF 
subparameter 10-181 
DSORG. 
subparameter of DD DCB parameter 10-51 
dsp 
parameter of JES3 //*-*PROCESS statement 22-50 
DSP (dynamic support program) 
calling of 22-50 
DUMMY 
DD statement parameter 10-86 
description 10-86 
examples 10-87 
parameters 10-86 
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relationship to other control statements 10-87 
relationship to other parameters 10-87 
in concatenations 10-12 
referenced in VOLUME= REF 
subparameter 10-183 
same effect with NULLFILE 10-84 
DUMP 
subparameter of //*MAIN BYTES 
parameter 22-27 
subparameter of //-MAIN CARDS 
parameter 22-28 


subparameter of //*MAIN LINES parameter 22-32 


subparameter of //*MAIN PAGES 
parameter 22-34 
subparameter on DD CHARS parameter 10-28 
subparameter on OUTPUT JCL CHARS 
parameter 17-12 
dumps 
duplicate requests for 11-16 
high-density 10-28, 10-94, 17-12, 17-34 
printing 11-15 
requesting on DD statement 10-30, 10-94 
requesting on OUTPUT JCL statement 17-12, 
17-34 
specifying by SYSABEND, SYSMDUMP, and 
SYSUDUMP DD statements 11-14 
storing 11-15 
DYNAM 
DD statement parameter 10-89 
description 10-89 
example 10-89 
relationship to other control statements 10-89 
relationship to other parameters 10-89 
dynamic support program 
See DSP (dynamic support program) 
DYNAMNBR 
EXEC statement parameter 14-17 
defaults 14-17 
description 14-17 
example 14-18 
subparameter 14-17 


subparameter of //*DATASET DDNAME 
parameter 22-5 


subparameter of DCB BFTEK subparameter 10-49 


subparameter of DCB CPRI subparameter 10-50 


subparameter of DCB MODE subparameter 10-53 
subparameter of DCB OPTCD subparameter 10-54 


subparameter of DCB TRTCH 
subparameter 10-58 


END 


subparameter of DD FREE parameter 10-99 
ENDCNTL 
JCL Statement 13-1 
comments field 13-1 
description 13-1 


example 13-2 
label field 13-1 
location in JCL 13-1 
operation field 13-1 
ENDDATASET JES3 statement 
See //FENDDATASET 
ENDPROCESS JES3 statement 
See //ENDPROCESS 
EOF JES2 statement 
See /*EOF 
EOV 
subparameter of DD CHKPT parameter 10-31 
EQ 
subparameter of EXEC COND parameter 14-10 
subparameter of JOB COND parameter 15-13 
EROPT 
subparameter of DD DCB parameter 10-52 
error 
in coding DD OUTPUT parameter 10-130 
in reading or writing a data set 
specifying options for 10-52 
error messages 
printing with PSF 17-25 
ES 
subparameter of DD RECORG parameter 10-141 
ET 
subparameter of DCB TRTCH 
subparameter 10-58 
EVEN 
subparameter of EXEC COND parameter 14-11 
EXCP (execute channel program) 
subparameters of DD DCB parameter 10-49 
EXEC 
JCL statement 14-1 
comments field 14-4 
description 14-1 
examples 14-4 
location in JCL 14-4 
name field 14-1 
operation field 14-2 
parameter field 14-2 
execute channel program 
See EXCP (execute channel program) 
execute statement 
See EXEC 
execution 
bypassing of 14-9, 15-13 
holding 15-41 
of job at network node 22-53 
restarting step 14-26, 15-30 
specifying program for 14-23 
timing 14-33, 15-38 
EXPDT 
DD statement parameter 10-90 
description 10-90 
examples 10-91 
overrides 10-91 
relationship to other parameters 10-91 
subparameters 10-90 
EXPDTCHK 
parameter of JES3 //*MAIN statement 22-30 


expiration, of data set 
deleting before 10-91, 10-146 
specifying in DD EXPDT parameter 10-90 
specifying in DD LABEL parameter 10-112 
external writer 
See writer, external 
EXTWTR 
parameter of JES3 //FFORMAT PR 
statement 22-16 
parameter of JES3 //*FORMAT PU 
statement 22-23 


subparameter of //*“ NET ABNORMAL 
parameter 22-42 
subparameter of //*NET NORMAL 
parameter 22-42 
subparameter of AMP RECFM 
subparameter 10-21 
subparameter of DCB BFALN subparameter 10-49 
subparameter of DCB OPTCD subparameter 10-54 
subparameter of DD RECFM parameter 10-136 
subparameter of RECFM parameter 10-137, 
10-138, 10-139 
FAILURE 
parameter of JES3 //*MAIN statement 22-31 
FB 
subparameter of AMP RECFM 
subparameter 10-21 
subparameter of DD RECFM parameter 10-136 
FBS 
subparameter of DD RECFM parameter 10-136 
FCB 
DD statement parameter 10-92 
defaults 10-93 
description 10-92 
examples 10-94 
overrides 10-93 
relationship to other control statements 10-93 
relationship to other parameters 10-93 
subparameters 10-92 
defining for work station 10-94 
OUTPUT JCL statement parameter 17-33 
defaults 17-34 
description 17-33 
example 17-34 
overrides 17-34 
relationship to other parameters 17-34 
subparameters 17-33 
parameter of JES2 /“OUTPUT statement 21-19 
parameter of JES3 //*FORMAT PR 
statement 22-16 


fcb-name 


.subparameter of OUTPUT JCL FCB 
parameter 17-33 
subparameter of DD FCB parameter 10-92 
FETCH 
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parameter of JES3 //*MAIN statement 22-31 
fields, in statements 
chart of 3-2 
comments 
format for 3-2 
rules for continuing 3-5 
continuing to following statements 3-5 
identifier 
format for 3-1 
location in statements 3-2 
name 
format for 3-1 
operation 
format for 3-1 
parameter 
detailed syntax for 3-3 
format for 3-2 
rules for continuing 3-5 
file definition statements 10-44 
FLASH 
DD statement parameter 10-96 
defaults 10-96 
description 10-96 
example 10-98 
overrides 10-97 
relationship to other control statements 10-97 
relationship to other parameters 10-97 
subparameters 10-96 
OUTPUT JCL statement parameter 17-35 
defaults 17-36 
description 17-35 
example 17-37 
overrides 17-36 
relationship to other parameters 17-36 
subparameters 17-35 
parameter of JES2 /*OUTPUT statement 21-19 
parameter of JES3 //*FORMAT PR 
statement 22-16 
FLASHC 
parameter of JES2 /*OUTPUT statement 21-20 
flashing 
printing with 10-96, 17-35 
printing without 10-98, 17-36 
relationship to DD COPIES parameter 10-36 
relationship to OUTPUT JCL COPIES 
parameter 17-23 
FLSH 
subparameter of //*NET NRCMP parameter 22-44 
FOLD 
subparameter of DD UCS parameter 10-170 
form-name 
subparameter of //*FORMAT FORMS 
parameter 22-17, 22-23 
subparameter of DD SYSOUT parameter 10-163 
subparameter of OUTPUT JCL FORMS 
parameter 17-40 
FORMAT PR JES3 statement 
See //*FORMAT PR 
FORMAT PU JES3 statement 
See //*FORMAT PU 
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format, of statements 
fields 3-1 
format, record 
See RECFM 
FORMDEF 
OUTPUT JCL statement parameter 17-38 
description 17-38 
example 17-39 
overrides 17-38 
subparameter 17-38 
FORMS 
OUTPUT JCL statement parameter 17-40 
defaults 17-40 
description 17-40 
example 17-40 
overrides 17-40 
subparameters 17-40 
parameter of JES2 /*JOBPARM statement 21-6 
parameter of JES2 /FOUTPUT statement 21-20 
parameter of JES3 //*FORMAT PR 
statement 22-17 
parameter of JES3 //*FORMAT PU 
statement 22-23 
forms 
for printing or punching 10-92, 17-33 
JES2 format subparameter of JOB accounting 
information 15-7 
specifying on OUTPUT JCL FORMS 
parameter 17-40 
specifying on sysout DD statement 10-161 
forms control buffer (FCB) 
See FCB 
forms overlay, printing with 
See flashing 
forward references 
See references 
FREE 
affect on JES2 /*JOBPARM COPIES 
parameter 21-6 
DD statement parameter 10-99 
defaults 10-99 
description 10-99 
examples 10-100 
overrides 10-99 
relationship to other contro] statements 10-100 
relationship to other parameters 10-99 
subparameters 10-99 
FS 
subparameter of DD RECFM parameter 10-136 
FUNC 
subparameter of DD DCB parameter 10-52 
with LABEL parameter 10-112 


G 


GAM (graphics access method) 

subparameters of DD DCB parameter 10-49 
GE 

subparameter of EXEC COND parameter 14-10 


subparameter of JOB COND parameter 15-13 
generalized trace facility 
See GFT (generalized trace facility) 
generation 
subparameter of DD DSNAME parameter 10-83 
GENERIC 
subparameter of DD SECMODEL 
parameter 10-148 
GFT (generalized trace facility) 
use of 10-51 
GNCP 
subparameter of DD DCB parameter 10-52 
graphics access method 
See GAM (graphics access method) 
GROUP 
JOB statement parameter 15-15 
defaults 15-15 
description 15-15 
example 15-16 
relationship to other parameters 15-16 
subparameter 15-15 
group-name 
See also name 
subparameter of //*FORMAT DEST 
parameter 22-15, 22-23 
subparameter of //*MAIN ORG parameter 22-34 
subparameter of DD DEST parameter 10-65 
subparameter of DD UNIT parameter 10-174 
subparameter of JOB GROUP parameter 15-15 
subparameter of OUTPUT JCL DEST 
parameter 17-31 
group-value 
subparameter of /*OUTPUT COPIES 
parameter 21-16 
subparameter of /*OUTPUT COPYG 
parameter 21-17 
subparameter of //*FORMAT COPIES 
parameter 22-14 
subparameter of DD COPIES parameter 10-35 
subparameter of OUTPUT JCL COPIES 
parameter 17-22 
group, output 
specifying on the OUTPUT JCL statement 17-41 
GROUPID 
OUTPUT JCL statement parameter 17-41 
description 17-41 
examples 17-42 
relationship to other control statements 17-41 
subparameter 17-41 
GS 
subparameter of DCB DSORG 
subparameter 10-51 
GT 
subparameter of EXEC COND parameter 14-10 
subparameter of JOB COND parameter 15-13 
G11 
character set for 3211 10-171, 17-63 


H 
subparameter of DCB OPTCD 
subparameter 10-54, 10-55 
hard-copy log, job 
request to not print 21-6 
sending messages to, in JES3 system 22-48 
specifying processing of 17-44 
HC 
NHOLD parameter of JES3 //*NET 
Statement 22-41 
held class 
See class, output, held (in JES2 system) 
HIGH 
subparameter of //*MAIN IORATE 
parameter 22-32 
high-density 
See dumps 
HN 
character set for 1403 and 3203 Model 5 10-171, 
17-63 
HOLD 
affect on JES2 /*JOBPARM COPIES 
parameter 21-6 
DD statement parameter 10-102 
defaults 10-102 
description 10-102 
example 10-103 
overrides 10-102 
relationship to other control statements 10-103 
relationship to other parameters 10-103 
subparameters 10-102 
parameter of JES3 //*MAIN statement 22-32 
subparameter of //*MAIN FAILURE 
parameter 22-31 
subparameter of //*NET NRCMP parameter 22-44 
subparameter of JOB TYPRUN parameter 15-41 
holding jobs 
specifying 15-41 
HWS 
subparameter of //*MAIN MSS parameter 22-33 
subparameter of //*MAIN SETUP 
parameter 22-36 
H11 
character set for 3211 10-171, 17-63 


subparameter of AMP OPTCD 
subparameter 10-20 
subparameter of DCB FUNC subparameter 10-52 
subparameter of DCB OPTCD subparameter 10-56 
IBM standard labels 
See SL 
ID 
NETID parameter of JES3 //*NET 
statement 22-41 
id 
subparameter of DD DSID parameter 10-79 
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subparameter of DD MSVGP parameter 10-123 
IGNORE 
subparameter of //*MAIN THWSSEP 
parameter 22-38 
IL 
subparameter of AMP OPTCD 
subparameter 10-20 
image-name 
subparameter of //FFORMAT FCB 
parameter 22-16 
IN 
subparameter of DD LABEL parameter 10-111 
in-stream data 
for procedures 10-14 
multiple in-stream data sets ina step 10-14 
with DD * statement 10-13 
with DD DATA statement 10-40 
with JES3 //*DATASET statement 22-5 
in-stream procedures 
See procedures, cataloged and in-stream 
IND 
subparameter of /*JOBPARM SYSAFF 
parameter 21-7 
INDEX 
OUTPUT JCL statement parameter 17-43 
defaults 17-43 
description 17-43 
example 17-43 
relationship to other parameters 17-43 
subparameter 17-43 
parameter of JES2 /*“OUTPUT statement 21-20 
index 
subparameter of DD SPACE parameter for specific 
requests 10-154 
subparameter of DD SPACE parameter for system 
assignment 10-152 
indexing of print margins 
specifying on OUTPUT JCL statement 17-43, 
17-47 
information 
subparameter of EXEC PARM parameter 14-19 
input stream 
definition 2-1 
halting reading of, in JES3 system 22-49 
INT 
parameter of JES3 //*FORMAT PU 
statement 22-23 
interactive problem control system 
See IPCS (interactive problem control system) 
internal reader 
See reader, internal 
INTRDR 
See also reader 
subparameter of OUTPUT JCL WRITER 
parameter 17-65 
writer-name subparameter on DD SYSOUT 
parameter 10-163 
INTVL 
subparameter of DD DCB parameter 10-52 
IORATE 
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parameter of JES3 //*MAIN statement 22-32 
IPCS (interactive problem control system) 
to print dump 11-15 
IPLTXID 
subparameter of DD DCB parameter 10-52 
IS 
subparameter of DCB DSORG 
subparameter 10-51 
ISO/ANSI/FIPS Version | or 3 tape data set 
indicating in DD LABEL parameter 10-110 
restriction on DD DISP parameter 10-68 
with DD ACCODE parameter 10-16 
ISU 
subparameter of DCB DSORG 
subparameter 10-51 


parameter of JES3 //*DATASET statement 22-6 
subparameter of DCB OPTCD subparameter 10-55 
JCL (Gob control language) 
Statements 
format for 3-1 
introduced iii, 1-1 
subparameter of OUTPUT JCL JESDS 
parameter 17-44 
JCLHOLD 
subparameter of JOB TYPRUN parameter 15-41 
JCLTEST 
subparameter of EXEC PGM parameter 14-24 
JESDS 
location of statement containing 17-6 
OUTPUT JCL statement parameter 17-44 
description 17-44 
example 17-46 
location inJCL 17-45 
overrides 17-45 
subparameters 17-44 
JESJCL 
subparameter of //*FORMAT DDNAME 
parameter 22-12 
JESMSG 
subparameter of //FFORMAT DDNAME 
parameter 22-12 
JES2 
description 21-1 
locationin JCL 21-1 
statements 
format for 3-4 
introduced ili, 1-1 
JES3 
description 22-1 
examples 22-2 
location in JCL 22-1 
statements 
format for 3-4 
introduced iii, 1-1 
JGLOBAL 


subparameter of //*MAIN SYSTEM 
parameter 22-37 
JLOCAL 
subparameter of //FMAIN SYSTEM 
parameter 22-37 
job 
control 
tasks needed for iii 
JCL statement 15-1 
comments field 15-4 
description 15-1 
examples 15-4 
locationin JCL 15-4 
name field 15-1 
operation field 15-2 
parameter field 15-2 
subparameter of //*MAIN MSS parameter 22-33 
subparameter of //*MAIN SETUP 
parameter 22-36 
job 
background or batch jobs 
affect on DD TERM parameter 10-168 
beginning of 15-1 
definition 2-1 
dependent 
specifying in JES3 system 22-41 
entering 2-1 
foreground jobs 
affect on DD TERM parameter 10-168 
nonstandard processing 
described 22-50 
processing 2-2 
processing of 
controlling, in JES3 system 22-50 
specifying control of 15-1 
specifying control of in JES3 system 22-25 
restarting 
with EXEC COND parameter 14-12 
standard processing 
described 22-50 
job control language 
See JCL (job control language) 
job log 
assigning to an output class 15-17 
cataloged procedure statements in 6-2 
controlling listing from 15-19 
in-stream procedure statements in 6-2 
job control statements in 6-2 
listing of 6-1 
specifying processing of 17-44 
statements in listing 6-1 
symbolic parameters in 6-1 
job-level 
OUTPUT JCL statements 17-6 
JOBCAT DD statement 
description 11-2 
example 11-3 
location in JCL 11-2 
overriding with STEPCAT DD statement 11-8 
parameters 11-2 


relationship to other control statements 11-2 

relationship to STEPCAT 11-2 
jobclass 

subparameter of JOB CLASS parameter 15-11 
JOBLIB DD statement 

description 11-4 

examples 11-6 

locationin JCL 11-6 

overriding fora step 11-5, 11-12 

parameters 11-4 

relationship to other control statements 11-5 

relationship to STEPLIB 11-6 

with COND=ONLY parameter 14-12 
jobname 

coding 15-1 

subparameter of //*NET NETREL 

parameter 22-43 
subparameter of //* NET RELEASE 
parameter 22-45 

JOBPARM JES2 statement 

See /*JOBPARM 
JOURNAL 

parameter of JES3 //*MAIN statement 22-32 
JSTTEST 

subparameter of EXEC PGM parameter 14-24 


K 


K 
subparameter of DD AVGREC parameter 10-24 
KEEP 
subparameter of //*NET ABCMP parameter 22-42 
subparameter of DD DISP parameter 10-69, 10-70 
KEYLEN 
DD statement parameter 10-104 
description 10-104 
examples 10-105 
overrides 10-104 
relationship to other parameters 10-105 
subparameters 10-104 
subparameter of DD DCB parameter 10-53 
KEYOFF 
DD statement parameter 10-106 
description 10-106 
example 10-107 
overrides 10-106 
relationship to other parameters 10-106 
subparameters 10-106 
keys, data set 
specifying on DCB KEYLEN subparameter 10-53 
specifying on DD KEYLEN parameter 10-104 
specifying on DD KEYOFF parameter 10-106 
keyword 
See parameters, keyword 
KS 
subparameter of DD RECORG parameter 10-141 
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subparameter of AMP OPTCD 
subparameter 10-20 
subparameter of DCB BUFOFF 
subparameter 10-50 
subparameter of DCB OPTCD 
subparameter 10-54, 10-56 
LABEL 
DD statement parameter 10-108 
defaults 10-112 
description 10-108 
examples 10-113 
relationship to other control statements 10-112 
relationship to other parameters 10-112 
subparameters 10-109 
label, data set 
copying attributes from 10-45 
specifying in DD LABEL parameter 10-109 
type copied when DD statement referenced 10-183 
LE 
subparameter of EXEC COND parameter 14-10 
subparameter of JOB COND parameter 15-13 
length, block 
See block length 
library 
private 
specifying for job 11-4 
specifying for step 11-10 
procedure 
adding to 5-2 
use for procedures 2-1 
LIKE 
DD statement parameter 10-115 
description 10-115 
examples 10-116 
overrides 10-115 
relationship to other parameters 10-116 
subparameters 10-115 
LIMCT 
subparameter of DD DCB parameter 10-53 
limit 
subparameter of //*FORMAT THRESHLD 
parameter 22-18 
subparameter of OUTPUT JCL THRESHLD 
parameter 17-58 
limiting, of output 
by specifying DD OUTLIM parameter 10-126 
maximum size of sysout data set 17-58 
of lines per printed page 15-7, 17-48 
LINDEX 
OUTPUT JCL statement parameter 17-47 
defaults 17-47 
description 17-47 
example 17-47 
relationship to other parameters 17-47 
subparameter 17-47 
parameter of JES2 /*OUTPUT statement 21-20 
LINE 
subparameter of OUTPUT JCL PRMODE 
parameter 17-55 
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linect 
JES2 format subparameter of JOB accounting 
information 15-7 
OUTPUT JCL statement parameter 17-48 
defaults 17-48 
description 17-48 
example 17-48 
subparameter 17-48 
parameter of JES2 /*JOBPARM statement 21-6 
parameter of JES2 /“OUTPUT statement 21-21 
LINES 
parameter of JES2 /*JOBPARM statement 21-6 
parameter of JES3 //*MAIN statement 22-32 
lines 
JES2 format subparameter of JOB accounting 
information 15-6 
LOCAL 
parameter of JES2 /*“ROUTE statement 21-26 
subparameter of /*“OUTPUT DEST 
parameter 21-17 
subparameter of DD DEST parameter 10-63 
subparameter of OUTPUT JCL DEST 
parameter 17-30 
LOG 
See also job log 
subparameter of OUTPUT JCL JESDS 
parameter 17-44 
log 
JES2 format subparameter of JOB accounting 
information 15-7 
LOW 
subparameter of //*MAIN IORATE 
parameter 22-32 
lowercase 
in syntax 4-2 
LRECL 
DD statement parameter 10-117 
description 10-117 
examples 10-118 
overrides 10-118 
relationship to other parameters 10-118 
subparameters 10-117 
subparameter of DD DCB parameter 10-53 
LREGION 
parameter of JES3 //*MAIN statement 22-33 
LS 
subparameter of DD RECORG parameter 10-141 
LT 
subparameter of EXEC COND parameter 14-10 
subparameter of JOB COND parameter 15-13 
LTM 
subparameter of DD LABEL parameter 10-110 


M 


M 
subparameter of DCB OPTCD subparameter 10-56 
subparameter of DD AVGREC parameter 10-24 
subparameter of DD RECFM parameter 10-136 


subparameter of RECFM parameter 10-137, 
10-138 
m 
subparameter of //*FORMAT CHNSIZE 
parameter 22-13, 22-21 
MACREF operand of DCB macro instruction 
when coding DUMMY _ 10-87 
MAIN JES3 statement 
See //*MAIN 
main service 
in job processing 22-50 
main-name 
subparameter of //*MAIN SYSTEM 
parameter 22-37 
management class 
See MGMTCLAS 
management-class-name 
subparameter of DD MGMTCLAS 
parameter 10-119 
margins 
See indexing of print margins 
mass storage system 
See MSS 
MED 
subparameter of //*MAIN IORATE 
parameter 22-32 
member 
subparameter of DCB INTVL subparameter 10-52 
subparameter of DD DSNAME parameter 10-83, 
10-84 
membername 
subparameter of OUTPUT JCL FORMDEF 
parameter 17-38 
subparameter of OUTPUT JCL PAGEDEF 
parameter 17-51 
MESSAGE JES2 statement 
See /*“MESSAGE 
messages 
from functional subsystem 17-53 
specifying processing of 17-44 
subparameter of JOB MSGLEVEL 
parameter 15-19 
to operator, in JES3 system 22-48 
method, access 
See individual access methods 
MGMTCLAS 
DD statement parameter 10-119 
defaults 10-120 
description 10-119 
examples 10-120 
overrides 10-120 
relationship to other parameters 10-120 
subparameters 10-119 
minutes 
subparameter of EXEC TIME parameter 14-33 
subparameter of JOB TIME parameter 15-38 
mmm 
subparameter of //*MAIN BYTES 
parameter 22-27 
subparameter of //*MAIN CARDS 
parameter 22-28 


subparameter of //FMAIN LINES parameter 22-32 
subparameter of //*MAIN PAGES 
parameter 22-34 
MOD 
subparameter of DD DISP parameter 10-68 
MODE 
parameter of JES3 //*“DATASET statement 22-5 
subparameter of DD DCB parameter 10-53 
mode 
process, for printing 
specifying on OUTPUT JCL statement 17-55 
modification, of printed output 
by specifying copy-modification module 10-121, 
17-49 
MODIFY 
DD statement parameter 10-121 
defaults 10-122 
description 10-121 
example 10-122 
overrides 10-122 
relationship to other control statements 10-122 
relationship to other parameters 10-122 
subparameters 10-121 
OUTPUT JCL statement parameter 17-49 
defaults 17-50 
description 17-49 
example 17-50 
overrides 17-50 
relationship to other parameters 17-50 
subparameters 17-49 
parameter of JES2 /*OUTPUT statement 21-21 
parameter of JES3 //*FORMAT PR 
statement 22-17 
modifying procedure DD statements 
coding 5-3 
MODTRC 
parameter of JES2 /*OUTPUT statement 21-21 
module 
subparameter of AMP SYNAD 
subparameter 10-21 
module-name 
subparameter of /“OUTPUT MODIFY 
parameter 21-21 
subparameter of //*FORMAT MODIFY 
parameter 22-17 
subparameter of DD MODIFY parameter 10-121 
subparameter of OUTPUT JCL MODIFY 
parameter 17-49 
mounting of volumes 
deferred 
specifying 10-175 
parallel 
specifying 10-175 
MSG 
subparameter of OUTPUT JCL JESDS 
parameter 17-44 
msg-count 
subparameter of OUTPUT JCL PIMSG 
parameter 17-53 
MSGCLASS 
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JOB statement parameter 15-17 
defaults 15-17 
description 15-17 
examples 15-18 
subparameter 15-17 
subparameter of //* DATASET DDNAME 
parameter 22-6 
MSGLEVEL 
JOB statement parameter 15-19 
defaults 15-20 
description 15-19 
examples 15-20 
subparameters 15-19 
MSS 
affect of deferred mounting 10-176 
parameter of JES3 //*MAIN statement 22-33 
specifying in UNIT parameter 10-174 
specifying space for 10-154 
specifying volumes 10-183 
unit count for 10-175 
with DD MSVGP parameter 10-123 
MSVGP 
DD statement parameter 10-123 
description 10-123 
examples 10-125 
relationship to other parameters 10-124 
subparameters 10-123 
multivolume data set 
See data set, multivolume 
MXIG 
subparameter of DD SPACE parameter 10-153 


See also NO 

subparameter of /*JOBPARM BURST 
parameter 21-5 

subparameter of /*JOBPARM RESTART 
parameter 21-7 

subparameter of /*OUTPUT BURST 
parameter 21-16 

subparameter of DCB PCI subparameter 10-56 

n or number 

subparameter of /*JOBPARM BYTES 
parameter 21-5 

subparameter of /*JOBPARM CARDS 
parameter 21-5 

subparameter of /*JOBPARM COPIES 
parameter 21-5 

subparameter of /*JOBPARM LINECT 
parameter 21-6 

subparameter of /*JOBPARM LINES 
parameter 21-6 

subparameter of /*JOBPARM PAGES 
parameter 21-6 

subparameter of /*JOBPARM TIME 
parameter 21-8 
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subparameter of /*OUTPUT CKPTLNS 
parameter 21-16 
subparameter of /*OUTPUT CKPTPGS 
parameter 21-16 
subparameter of /*OUTPUT COMPACT 
parameter 21-16 
subparameter of /“OUTPUT COPIES 
parameter 21-16 
subparameter of /*OUTPUT INDEX 
parameter 21-20 
subparameter of /*OUTPUT LINDEX 
parameter 21-20 
subparameter of /*OUTPUT LINECT 
parameter 21-21 
subparameter of //FFORMAT CHNSIZE 
parameter 22-13, 22-21 
subparameter of //*“FORMAT COPIES 
parameter 22-14, 22-22 
subparameter of //*FORMAT PRTY 
parameter 22-17 
subparameter of //*MAIN BYTES 
parameter 22-27 
subparameter of //*MAIN CARDS 
parameter 22-28 
subparameter of //*MAIN LINES parameter 22-32 
subparameter of //*MAIN PAGES 
parameter 22-34 
subparameter of //* NET DEVPOOL 
parameter 22-43 
subparameter of //*NET NHOLD parameter 22-44 
subparameter of //* NET RELSCHCT 
parameter 22-45 
subparameter of //*NETACCT ACCT 
parameter 22-46 
subparameter of AMP BUFND parameter 10-19 
subparameter of AMP BUFNI parameter 10-19 
subparameter of AMP STRNO parameter 10-21 
subparameter of DCB BUFOFF 
subparameter 10-50 
subparameter of DCB GNCP subparameter 10-52 
subparameter of DCB INTVL subparameter 10-52 
subparameter of DCB NCP parameter 10-53 
subparameter of DCB RKP subparameter 10-57 
subparameter of DCB THRESH 
subparameter 10-58 
subparameter of DD COPIES parameter 10-35 
subparameter of DD OUTLIM parameter 10-126 
subparameter of DD RETPD parameter 10-145 
subparameter of EXEC DYNAMNBR 
parameter 14-17 
subparameter of EXEC PERFORM 
parameter 14-2] 
subparameter of JOB PERFORM parameter 15-25 
subparameter of OUTPUT JCL CKPTPAGE 
parameter 17-15 
subparameter of OUTPUT JCL CKPTSEC 
parameter 17-16 
subparameter of OUTPUT JCL COPIES 
parameter 17-22 


subparameter of OUTPUT JCL INDEX 
parameter 17-43 
subparameter of OUTPUT JCL LINDEX 
parameter 17-47 
subparameter of OUTPUT JCL LINECT 
parameter 17-48 
subparameter of OUTPUT JCL PRTY 
parameter 17-57 
name 
in name field of OUTPUT JCL statement 17-1 
parameter of JES2 /*ROUTE statement 21-26 
qualified 
for data set 10-82 
subparameter of /*OUTPUT DEST 
parameter 21-17 
subparameter of //*FORMAT EXTWTR 
parameter 22-16, 22-23 
subparameter of //* NET NETID parameter 22-42 
subparameter of DD DEST parameter 10-63 
subparameter of OUTPUT JCL DEST 
parameter 17-30 
subparameter of OUTPUT JCL WRITER 
parameter 17-65 
unqualified 
for data set 10-82 
NC 
NORMAL parameter of JES3 //*NET 
statement 22-41 
subparameter of EXEC RD parameter 14-28 
subparameter of JOB RD parameter 15-31 
NCK 


subparameter of AMP CROPS subparameter 10-20 


NCP 
subparameter of DD DCB parameter 10-53 
NE 
subparameter of EXEC COND parameter 14-10 
subparameter of JOB COND parameter 15-13 
NET 
subparameter of //* NET DEVPOOL 
parameter 22-43 
NET JES3 statement 
See //*NET 
NETACCT JES statement 
See /*“NETACCT or //*NETACCT 
NETID 
parameter of JES3 //*NET statement 22-42 
subparameter of //*NET NETREL 
parameter 22-43 
NETREL 
parameter of JES3 //*NET statement 22-43 
network-account-number 
parameter of JES2 /*“NETACCT statement 21-11 
NEW 
subparameter of DD DISP parameter 10-67 
new-password 
subparameter of JOB PASSWORD 
parameter 15-24 
NHOLD 
parameter of JES3 //*NET statement 22-44 
NL 
subparameter of DD LABEL parameter 10-110 


parameter of JES2 /*“ROUTE statement 21-26 
parameter of JES2 /*XEQ statement 21-33 
parameter of JES2 /*XMIT statement 21-35 
subparameter of /*“OUTPUT DEST 
parameter 21-17, 21-18 
subparameter of DD DEST parameter 10-63, 
10-64 
subparameter of OUTPUT JCL DEST 
parameter 17-30 
nnnnK 
subparameter of //*MAIN LREGION 
parameter 22-33 
NO 
subparameter of //*DATASET DDNAME 
parameter 22-6 
subparameter of //*FORMAT FORMS 
parameter 22-23 
subparameter of //*MAIN EXPDTCHK 
parameter 22-30 
subparameter of //*MAIN HOLD parameter 22-32 
subparameter of //*MAIN JOURNAL 
parameter 22-32 
subparameter of //*MAIN RINGCHK 
parameter 22-35 
subparameter of //* NET DEVRELSE 
parameter 22-43 
subparameter of //*NET OPHOLD 
parameter 22-44 
subparameter of DD BURST parameter 10-26 
subparameter of DD HOLD parameter 10-102 
subparameter of OUTPUT JCL BURST 
parameter 17-9 
subparameter of OUTPUT JCL DEFAULT 
parameter 17-27 
subparameter of OUTPUT JCL PIMSG 
parameter 17-53 
subparameter of OUTPUT JCL TRC 
parameter 17-60 
node 
affect on JES2 /*JOBPARM COPIES 
parameter 21-8 
of execution 21-8 
subparameter of DD DEST parameter 10-64, 
10-65 
nodename 
parameter of JES2 /*“NOTIFY statement 21-12 
parameter of JES2 /*“ROUTE statement 21-26, 
21-27 
parameter of JES2 /*XEQ statement 21-33 
parameter of JES2 /*XMIT statement 21-35 
parameter of JES3 //FROUTE XEQ = 22-53 
subparameter of /*“OUTPUT DEST 
parameter 21-18 
subparameter of //*FORMAT DEST 
parameter 22-15, 22-23 
subparameter of //*MAIN ORG parameter 22-34 
subparameter of DD DEST parameter 10-65 
subparameter of OUTPUT JCL DEST 
parameter 17-31 
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subparameter of OUTPUT JCL DEST 
parameter 17-31 
subparameter of XMIT JCL DEST parameter 20-5 
NOHO 
subparameter of //*NET NRCMP parameter 22-44 
NOKP 
subparameter of //-NET ABCMP parameter 22-42 
NOLOG 
parameter of JES2 /*JOBPARM statement 21-6 
NONE 
subparameter of /*OUTPUT FLASH 
parameter 21-19 
subparameter of //*MAIN FETCH 
parameter 22-31 
subparameter of DD FLASH parameter 10-96 
subparameter of OUTPUT JCL FLASH 
parameter 17-35 
nonpageable storage 
See storage, real (nonpageable) 
nonspecific volumes 
See volumes, nonspecific requests 
nonstandard labels 
See NSL 
NOPWREAD 
subparameter of DD LABEL parameter 10-111 
NORMAL 
parameter of JES3 //*NET statement 22-42 
normal termination 
See termination, normal 
notation 
for syntax 4-1 
notification 
of job completion 15-21 
receiving 15-21 
NOTIFY 
JOB statement parameter 15-21 
description 15-21 
example 15-22 
relationship to JES2 /*JOBPARM SYSAFF 
parameter 15-21 
subparameter 15-21 
NOTIFY JES2 statement 
See /*NOTIFY 
NR 
NETREL parameter of JES3 //*NET 
statement 22-41 
subparameter of EXEC RD parameter 14-27 
subparameter of JOB RD parameter 15-31 
NRC 
subparameter of AMP CROPS subparameter 10-20 
NRCMP 
parameter of JES3 //*NET statement 22-44 
NRE 
subparameter of AMP CROPS subparameter 10-20 
NSL 
subparameter of DD LABEL parameter 10-110 
NTM 
subparameter of DD DCB parameter 10-54 
null 
JCL statement 16-1 
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description 16-1 
example 16-2 
locationin JCL 16-1 
subparameter of //*FORMAT DDNAME 
parameter 22-12, 22-21 
NULLFILE 
subparameter of DD DSNAME parameter 10-84 
number parameter 
See n or number 
NxRnnnn 
parameter of JES2 /*SIGNON statement 21-32 


O 


O 
subparameter of DCB MODE subparameter 10-53 
OFF 
subparameter of //*FORMAT OVLY 
parameter 22-17 
offset-to-key 
subparameter of DD KEYOFF parameter 10-106 
OH 
OPHOLD parameter of JES3 //*NET 
statement 22-41 
OLD 
subparameter of DD DISP parameter 10-67 
omitting 
ddname from DD statement 10-2 
ON 
subparameter of //FFORMAT OVLY 
parameter 22-17 
ONLY 
subparameter of EXEC COND parameter 14-11 
operating system 
contents 2-1 
operator 
messages to, in JES3 system 22-48 
subparameter of EXEC COND parameter 14-10 
subparameter of JOB COND parameter 15-13 
operator commands 
entered through JCL command statement 7-1 
entered through JES2 command statement 21-2 
entered through JES3 command statement 22-3 
OPERATOR JES3 statement 
See //*FOPERATOR 
OPHOLD 
parameter of JES3 //*NET statement 22-44 
OPTCD 
subparameter of DD AMP parameter 10-20 
subparameter of DD DCB parameter 10-54 
ORG 
parameter of JES3 //*MAIN statement 22-34 
organization 
subparameter of DCB DSORG 
subparameter 10-51 
OUT 
subparameter of DD LABEL parameter 10-111 
OUTLIM 
DD statement parameter 10-126 


default 10-126 
description 10-126 
example 10-127 
relationship to other control statements 10-127 
relationship to other parameters 10-126 
subparameter 10-126 
OUTPUT 
DD statement parameter 10-128 
defaults 10-129 
description 10-128 
examples 10-131 
location in JCL 10-130 
overrides 10-129 
relationship to other parameters 10-130 
subparameters 10-129 
JCL statement 17-1 
comments field 17-5 
default, defined 17-5 
description 17-1 
example of job and step-level statements 17-6 
job-level statements 17-6 
location in JCL 17-6 
location in procedures 17-6 
location of default statements 17-6 
name field 17-1 
operation field 17-2 
overrides 17-7 
parameter field 17-2 
relationship to JES2 /*OUTPUT 
statement 17-8 
relationship to JES3 //FFORMAT 
statement 17-8 
relationship to sysout DD statement 17-7 
step-level statements 17-6 
limiting from job 15-6 
specifying number of copies 10-35, 17-22, 22-14 
OUTPUT JES2 statement 
See /*OUTPUT 
output service 
in job processing 22-50 
output-group 
subparameter of OUTPUT JCL GROUPID 
parameter 17-41 
overflow 
holding 10-50 
overlay-name 
subparameter of /“OUTPUT FLASH 
parameter 21-19 
subparameter of //FFORMAT FLASH 
parameter 22-16 
subparameter of DD FLASH parameter 10-96 
subparameter of OUTPUT JCL FLASH 
parameter 17-35 
overlay, forms = 
See flashing 
overrides, of cataloged and in-stream procedure 
statements 
of DD statements 5-3 
of EXEC statement parameters 5-2 
of OUTPUT JCL statements 5-3 
with DD DUMMY statement 10-87 


OVFL 
parameter of JES3 //*FORMAT PR 
Statement 22-17 


P 

P 
subparameter of DCB FUNC subparameter 10-52 
subparameter of DD UNIT parameter 10-175 

p 


parameter of /*PRIORITY statement 21-23 
PAGE 
subparameter of OUTPUT JCL PRMODE 
parameter 17-55 
page-mode printer 
on OUTPUT JCL FORMDEF parameter 17-38 
on OUTPUT JCL PAGEDEF parameter 17-51 
on OUTPUT JCL PRMODE parameter 17-55 
pageable storage 
See storage, virtual (pageable) 
PAGEDEF 
OUTPUT JCL statement parameter 17-51 
description 17-51 
example 17-52 
overrides 17-52 
subparameter 17-51 
PAGES 
parameter of JES2 /*JOBPARM statement 21-6 
parameter of JES3 //‘MAIN statement 22-34 
pages, in printed output 
limiting length of 15-7, 17-48 
pano 
JES2 format subparameter of JOB accounting 
information 15-6 
parameter 
See individual parameters 
parameters, keyword 
on DD statement 10-3 
on EXEC statement 14-2 
on EXEC statement that calls procedure 14-4 
on JOB statement 15-2 
on OUTPUT JCL statement 17-2 
syntax for 3-3 
warning on other uses of 3-3 
parameters, positional 
on DD statement 10-3 
on EXEC statement 14-2 
on JOB statement 15-2 
optionally required by installation 15-5, 15-26 
syntax for 3-3 
parameters, symbolic 
assigning values to 5-10 
cautions about leading and trailing commas 
around 5-11 
coding of 5-8 
default values for 5-10 
examples 5-12 
length of assigned value for 5-10 
location of 5-8 


Index X-23 


multiple values for 5-10 
nullifying 5-10 
purpose of 5-8 
syntax for 5-8 
PARM 
EXEC statement parameter 
description 14-19 
examples 14-20 
subparameter 14-19 
partition-name 


subparameter of //*MAIN SPART 


parameter 22-37 
PASS 


subparameter of DD DISP parameter 


passed data sets 
See data set, passed 
PASSWORD 
JOB statement 15-23 
description 15-23 
examples 15-24 


relationship to other parameters 


subparameters 15-24 


10-69 


15-24 


subparameter of DD LABEL parameter 10-111 


subparameter of JOB PASSWORD 


parameter 15-24 
passwords 
for protection of data sets 
password 1 


parameter of JES2 /*SIGNON statement 21-32 
parameter of JES3 /*SIGNON statement 22-56 


password2 


parameter of JES2 /*SIGNON statement 21-32 
parameter of JES3 /*SIGNON statement 22-57 


PAUSE JES3 statement 
See //*PAUSE 
PC 


NRCMP parameter of JES3 //* NET 


statement 22-41 
PCAN 


character set for 1403 and 3203 Model 5 10-171, 


17-63 
PCHN 


character set for 1403 and 3203 Model 5 10-171, 


17-63 
PCI 


subparameter of DD DCB parameter 


PEND 
JCL statement 18-1 
comments field 18-1 
description 18-1 
examples 18-2 
location in JCL 18-2 
name field 18-1 
operation field 18-1 
PERFORM 
EXEC statement parameter 
defaults 14-21 
description 14-21 
examples 14-22 
overrides 14-21 
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10-56 


subparameter 14-21 
JOB statement parameter 15-25 
defaults 15-25 
description 15-25 
example 15-25 
overrides 15-25 
subparameter 15-25 
performance group 
specifying on the EXEC statement 14-21 
specifying on the JOB statement 15-25 
PGM 
EXEC statement parameter 14-23 
description 14-23 
examples 14-24 
subparameters 14-23 
location of specified program 11-4, 11-10 
PIMSG 
OUTPUT JCL statement parameter 17-53 
defaults 17-54 
description 17-53 
example 17-54 
subparameters 17-53 
PN 
character set for 1403 and 3203 Model 5 10-171, 
17-63 
PNAME 
parameter of JES3 //*NETACCT statement 22-46 
PO 
subparameter of DCB DSORG 
subparameter 10-51 
position of tape data set 
See data-set-sequence-number 
positional 
See parameters, positional 
POU 
subparameter of DCB DSORG 
subparameter 10-51 
PR 
parameter of JES3 //*FORMAT PR 
statement 22-11 
PRDMP service aid 
to print dump 11-15 
PREFER 
subparameter of //*MAIN THWSSEP 
parameter 22-38 
primary-qty 
subparameter of //*MAIN TRKGRPS 
parameter 22-38 
subparameter of DD SPACE parameter for specific 
requests 10-153 
subparameter of DD SPACE parameter for system 
assignment 10-150 
PRINT 
parameter of JES2 /*ROUTE statement 21-25 
subparameter of //*MAIN FAILURE 
parameter 22-31 
Print Services Facility 
See PSF (Print Services Facility) 
printing, of output data set 
controlling spacing in output 17-21, 22-14 


processing instructions for, in JES3 system 22-10 
priority 
APG (automatic priority group) 
assignment of 14-16 
dispatching 
specifying 14-15 
initiation or selection 
specifying 15-28 
of lines for transmission 10-50 
output queue 
specifying, for sysout data set 17-57 
queue selection 
specifying 15-28 
requested on JES2 /*PRIORITY statement 21-23 
subparameter of JOB PRTY parameter 15-28 
PRIORITY JES2 statement 
See /*PRIORITY 
PRIVATE 
subparameter of DD VOLUME parameter 10-179 
PRMODE 
OUTPUT JCL statement parameter 17-55 
defaults 17-55 
description 17-55 
example 17-56 
subparameters 17-55 
PROC 
EXEC statement parameter 14-25 
description 14-25 
examples 14-25 
subparameter 14-25 
JCL statement 19-1 
comments field 19-2 
description 19-1 
examples 19-3 
location in JCL 19-2 
name field 19-2 
operation field 19-2 
overrides 19-2 
parameter field 19-2 
parameter of JES3 //*MAIN statement 22-35 
procedure-name 
subparameter of EXEC PROC parameter 14-25 
procedures, cataloged and in-stream 
affect of parameters on calling EXEC 
statement 14-4 
calling 14-25 
cataloging 5-2 
ddname when overriding or adding to 
procedure 10-2 
definition 2-1 
description 5-1 
effect of PROC parameter on other parameters and 
following statements 14-25 
examples 5-6 
examples, showing symbolic parameters 5-12 
in-stream data for 10-14 
indicating end for in-stream 18-1 
indicating start of 19-1 
location of DD statements when overriding or 
adding to procedure 10-11 
maximum per job 5-1 


modifying DD statements 5-3 
modifying OUTPUT JCL statements 5-3 
overriding ACCT parameter in 14-6 
overriding ADDRSPC parameter in 14-8 
overriding COND parameter in 14-11 
overriding DPRTY parameter in 14-16 
overriding DY NAMNBR parameter in 14-17 
overriding EXEC statement parameters 5-2 
overriding PARM parameter in 14-20 
overriding PERFORM parameter in 14-22 
overriding RD parameter in 14-28 
overriding REGION parameter in 14-31 
overriding TIME parameter in 14-34 
statements as listed in job log 6-2 
statements valid in procedures 5-1 
symbolic parameters in 5-8 
testing 2-1, 5-1 
using 5-1 
PROCESS JES3 statement 
See //*PROCESS 
process-mode 
subparameter of OUTPUT JCL PRMODE 
parameter 17-55 
processing, of data sets 
for input or output 10-111 
with multiple references in DD OUTPUT 
parameter 10-130 
processor-id 
subparameter of //*MAIN ACMAIN 
parameter 22-27 
PROCLIB 
parameter of JES2 /*JOBPARM statement 21-6 
procname 
subparameter of DD QNAME parameter 10-135 
procstepname 
subparameter of EXEC ACCT parameter 14-6 
subparameter of EXEC ADDRSPC 
parameter 14-8 
subparameter of EXEC COND parameter 14-11 
subparameter of EXEC DPRTY parameter 14-16 
subparameter of EXEC DYNAMNBR 
parameter 14-17 
subparameter of EXEC PARM parameter 14-20 
subparameter of EXEC PERFORM 
parameter 14-22 
subparameter of EXEC RD parameter 14-28 
subparameter of EXEC REGION parameter 14-31 
subparameter of EXEC TIME parameter 14-34 
profile-name 
subparameter of DD SECMODEL 
parameter 10-148 
profile, discrete 
See RACF (Resource Access Control Facility) 
PROGRAM 
subparameter of //*“FORMAT CONTROL 
parameter 22-14 
subparameter of OUTPUT JCL CONTROL 
parameter 17-21 
program 
executing 14-23 
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location of executable programs 11-4, 11-10 
program control 9-1 
program control statements 9-2 
end of 13-1 
program-name 
subparameter of EXEC PGM parameter 14-23 
programmer’s-name 
JOB statement parameter 15-26 
description 15-26 
examples 15-27 
parameter 15-26 
subparameter of //*NETACCT PNAME 
parameter 22-46 
PROTECT 
DD statement parameter 10-132 
description 10-132 
examples 10-134 
overrides 10-133 
relationship to other parameters 10-133 
requirements for protecting direct access data 
set 10-134 
requirements for protecting tape data 
set 10-133 


requirements for protecting tape volume 10-133 


subparameters 10-132 
protection 
of data sets 
by passwords 10-111 
through DD PROTECT parameter 10-132 
through DD SECMODEL parameter 10-147 
PRTSP 
subparameter of DD DCB parameter 10-57 
PRTY 
JOB statement parameter 15-28 
defaults 15-28 
description 15-28 
example 15-29 
overrides 15-29 
subparameter 15-28 
OUTPUT JCL statement parameter 17-57 
defaults 17-57 
description 17-57 
example 17-57 
overrides 17-57 
subparameter 17-57 
parameter of JES3 //*FORMAT PR 
statement 22-17 
PS 
subparameter of DCB DSORG 
subparameter 10-51 
PSF (Print Services Facility) 
for printing line-mode data 17-55 
specifying how to print data set 17-38, 17-51 
specifying table reference character codes for, in 
JES2 system 17-60 
with DD CHARS parameter 10-29 
with DD UCS parameter 10-171 
with OUTPUT JCL CHARS parameter 17-12 
with OUTPUT JCL DATACK parameter 17-25 
with OUTPUT JCL PIMSG parameter 17-53 
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with OUTPUT JCL UCS parameter 17-63 
PSU 
subparameter of DCB DSORG 
subparameter 10-51 
PU 
parameter of JES3 //*FORMAT PU 
statement 22-21 
PUNCH 
parameter of JES2 /*ROUTE statement 21-25 
punching, of output data set 
processing options for, in JES3 system 22-20 
PURGE JES2 statement 
See /*PURGE 
purge service 
in job processing 22-50 
P11 
character set for 3211 10-171, 17-63 


Q 
Q 


subparameter of DCB OPTCD subparameter 10-55 


QISAM (queued indexed sequential access method) 
subparameters of DD DCB parameter 10-49 
QN 
character set for 1403 and 3203 Model 5_ 10-171, 
17-63 
QNAME 
DD statement parameter 10-135 
description 10-135 
examples 10-135 
relationship to other parameters 10-135 
subparameters 10-135 
QNC 
character set for 1403 and 3203 Model 5 10-171, 
17-63 
QSAM (queued sequential access method) 
subparameters of DD DCB parameter 10-49 
with DD CHKPT parameter 10-31 
qualified 
See name 
queued indexed sequential access method 
See QISAM (queued indexed sequential access 
method) 
queued sequential access method 
See QSAM (queued sequential access method) 


parameter of JES3 /*SIGNON statement 22-56 
subparameter of //*NET ABNORMAL 
parameter 22-42 
subparameter of //*NET NORMAL 
parameter 22-42 


subparameter of DCB BFTEK subparameter 10-49 


subparameter of DCB CPRI subparameter 10-50 
subparameter of DCB FUNC subparameter 10-52 


subparameter of DCB MODE subparameter 10-53 


subparameter of DCB OPTCD 
subparameter 10-54, 10-56 
subparameter of DCB PCI subparameter 10-56 
subparameter of EXEC RD parameter 14-27 
subparameter of JOB RD parameter 15-31 
RACF (Resource Access Control Facility) 
protection through DD PROTECT 
parameter 10-132 
protection through DD SECMODEL 
parameter 10-147 
specifying new password 15-23 
specifying RACF-defined group 15-15 
specifying RACF-defined password 15-23 
specifying RACF-defined user 15-43 
using discrete profile 10-132 
RCK 


subparameter of AMP CROPS subparameter 10-20 


RD 
EXEC statement parameter 14-26 
defaults 14-28 
description 14-26 
examples 14-29 
overrides 14-28 
relationship to other control statements 14-28 
subparameters 14-27 
JOB statement parameter 15-30 
defaults 15-32 
description 15-30 
examples 15-32 
overrides 15-32 
relationship to other control statements 15-32 
subparameters 15-31 
RDJFCB macro instruction 10-12 
reader, internal 
definition 2-1 
submitting jobs to 21-1, 22-1 
with XMIT JCL statement (JES3) 20-1, 20-8 
REAL 
subparameter of EXEC ADDRSPC 
parameter 14-7 
subparameter of JOB ADDRSPC parameter 15-9 
real storage 
See storage, real (nonpageable) 
reassignment, of printer 10-30 
JCL statement 
relationship to DD statement COPIES 
parameter 10-37 
RECFM 
DD statement parameter 10-136 
description 10-136 
examples 10-140 
overrides 10-139 
relationship to other parameters 10-139 
subparameter of DD AMP parameter 10-21 
reclgth 
subparameter of DD SPACE parameter 10-150 
record format 
See RECFM 
record length 
specifying in the DD SPACE parameter 10-150 


records 
specifying length of 10-24, 10-53, 10-117 
specifying organization 10-141 
RECORG 
DD statement parameter 10-141 
defaults 10-141 
description 10-141 
examples 10-142 
overrides 10-142 
relationship to other parameters 10-142 
subparameters 10-141 
REF 
subparameter of DD VOLUME parameter 10-181 
REFDD 
DD statement parameter 10-143 
description 10-143 
example 10-144 
overrides 10-144 
relationship to other parameters 10-144 
subparameters 10-143 
references 
backward 
coding of 10-61 
examples 4-7 
explanation and coding 4-6 
to concatenated data sets 10-12 
with EXEC COND parameter 14-12 


explicit 

to OUTPUT JCL statements 17-6, 17-28 
forward 

to concatenated data sets 10-12 
implicit 


specifying, using OUTPUT JCL DEFAULT 
parameter 17-27 
to OUTPUT JCL statements 17-6, 17-28 
with DD DUMMY statement 10-87 
REGION 
EXEC statement parameter 14-30 
defaults 14-31 
description 14-30 
examples 14-32 
overrides 14-31 
relationship to the EXEC ADDRSPC 
parameter 14-31 
subparameters 14-31 
JOB statement parameter 15-33 
default 15-34 
description 15-33 
examples 15-34 
overrides 15-34 
relationship to the JOB ADDRSPC 
parameter 15-34 
subparameters 15-34 
region 
specifying size of 14-30, 15-33 
region size, default 14-31, 15-34 
rel 
subparameter of //*MAIN DEADLINE 
parameter 22-29 
RELEASE 
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parameter of JES3 //*NET statement 22-45 
RELSCHCT 
parameter of JES3 //*NET statement 22-45 
remote 
subparameter of //*FORMAT DEST 
parameter 22-15, 22-23 
subparameter of //*MAIN ORG parameter 22-34 
remote job entry (RJE) 
See SNA (systems network architecture) RJE or 
RJP (remote job entry or processing) 
remote job processing (RJP) 
See SNA (systems network architecture) RJE or 
RJP (remote job entry or processing) 
REMOTEnnn 
parameter of JES2 /*SIGNON statement 21-31 
REQUIRE 
subparameter of //*MAIN THWSSEP 
parameter 22-38 
RESERVE 
subparameter of DD DCB parameter 10-57 
resource access control facility 
See RACF (Resource Access Control Facility) 
RESTART 
JOB statement parameter 15-35 
cautions with coding 15-36 
description 15-35 
examples 15-37 
relationship to other control statements 15-36 
subparameters 15-35 
parameter of JES2 /*JOBPARM statement 21-7 
subparameter of //*MAIN FAILURE 
parameter 22-31 
with EXEC COND parameter 14-12 
restart definition 
See RD 
restarting, of execution 
at checkpoint 15-35 
at step 15-35 
requesting for all steps in job 15-30 
requesting for step 14-26 
specifying 15-35 
RETAIN 
subparameter of DD VOLUME parameter 10-179 
retention, of data set 
deleting before 10-146 
specifying in DD RETPD parameter 10-145 
retention, of volume 
specifying by RETAIN subparameter 10-179 
RETPD 
DD statement parameter 10-145 
description 10-145 
examples 10-146 
overrides 10-145 
relationship to other parameters 10-146 
subparameters 10-145 
return code tests 
See tests, return code 
RINGCHK 
parameter of JES3 //*MAIN statement 22-35 
RJE (remote job entry) 
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See SNA (systems network architecture) RJE or 
RJP (remote job entry or processing) 
RJP (remote job processing) 
See SNA (systems network architecture) RJE or 
RJP (remote job entry or processing) 
RKP 
subparameter of DD DCB parameter 10-57 
RL 
RELEASE parameter of JES3 //*NET 
statement 22-41 
RLSE 
subparameter of DD SPACE parameter 10-152 
Rm 
parameter of JES2 /*ROUTE statement 21-26 
subparameter of /*OUTPUT DEST 
parameter 21-18 
subparameter of DD DEST parameter 10-64 
subparameter of OUTPUT JCL DEST 
parameter 17-30 
RMn 
parameter of JES2 /*“ROUTE statement 21-26 
parameter of JES2 /*SIGNON statement 21-31 
subparameter of /OUTPUT DEST 
parameter 21-18 
subparameter of DD DEST parameter 10-64 
subparameter of OUTPUT JCL DEST 
parameter 17-31 
RMTn 
parameter of JES2 /*ROUTE statement 21-26 
parameter of JES2 /*SIGNON statement 21-31 
subparameter of /*OUTPUT DEST 
parameter 21-18 
subparameter of DD DEST parameter 10-64 
subparameter of OUTPUT JCL DEST 
parameter 17-31 
RN 
character set for 1403 and 3203 Model 5 10-171, 
17-63 
Rn 
parameter of JES2 /*ROUTE statement 21-26 
subparameter of /*OUTPUT DEST 
parameter 21-18 
subparameter of DD DEST parameter 10-64 
subparameter of OUTPUT JCL DEST 
parameter 17-31 
RNC 
subparameter of EXEC RD parameter 14-27 
subparameter of JOB RD parameter 15-31 
Rnnnn 
parameter of JES2 /*SIGNON statement 21-31 
ROOM 
parameter of JES2 /*JOBPARM statement 21-7 
parameter of JES3 //*NETACCT statement 22-46 
room 
JES2 format subparameter of JOB accounting 
information 15-6 
subparameter of //*NETACCT ROOM 
parameter 22-46 
ROUND 
subparameter of DD SPACE parameter 10-153 


ROUTE JES2 statement 

See /*ROUTE 
ROUTE XEQ JES3 statement 

See //*ROUTE XEQ 
RR 

subparameter of DD RECORG parameter 10-141 
RS 

RELSCHCT parameter of JES3 //*NET 

statement 22-41 


subparameter of //*FORMAT STACKER 
parameter 22-18 
subparameter of DCB BFTEK subparameter 10-49 
subparameter of DCB CPRI subparameter 10-50 
subparameter of RECFM parameter 10-137, 
10-138 
SCAN 
subparameter of JOB TYPRUN parameter 15-42 
SCAN JES2 statement 
See /FSCAN 
SDGxx 
subparameter of //* NET DEVPOOL 
parameter 22-43 
SECMODEL 
DD statement parameter 10-147 
description 10-147 
examples 10-148 
overrides 10-148 
relationship to other parameters 10-148 
subparameters 10-148 
second-qty 
subparameter of //*MAIN TRKGRPS 
parameter 22-38 
subparameter of DD SPACE parameter 10-151 
seconds 
subparameter of EXEC TIME parameter 14-33 
subparameter of JOB TIME parameter 15-38 
sending to remote node 
of input stream for execution 22-53 
SER 
subparameter of DD VOLUME parameter 10-181 
serial number for volume 
See volumes, serial numbers 
serial-number 
parameter of JES2 /*SETUP statement 21-29 
subparameter of VOLUME=SER 
subparameter 10-181 
SETUP 
parameter of JES3 //*MAIN statement 22-36 
subparameter of //*MAIN FETCH 
parameter 22-31 
SETUP JES2 statement 
See /*SETUP 
SHR 
subparameter of DD DISP parameter 10-68 
SIGNOFF JES statement 
See /*SIGNOFF 


SIGNON JES statement 
See /*SIGNON 
SINGLE 
subparameter of //*FORMAT CONTROL 
parameter 22-14 
subparameter of OUTPUT JCL CONTROL 
parameter 17-21 
size, block 
See BLKSIZE 
SKP 
subparameter of DCB EROPT subparameter 10-52 
SL 
subparameter of DD LABEL parameter 10-109 
slash (/) 
See / (slash) 
slash asterisk (/*) 
See /* (slash asterisk) 
SMS (Storage Management Subsystem) 
See also SMS-managed data sets 
with data set password protection 10-111 
with DD AMP parameter 10-18 
with DD AVGREC parameter 10-24 
with DD DATACLAS parameter 10-42 
with DD DCB parameter 10-44 
with DD EXPDT parameter 10-90 
with DD KEYLEN parameter 10-104 
with DD KEYOFF parameter 10-106 
with DD LIKE parameter 10-i15 
with DD LRECL parameter 10-117 
with DD MGMTCLAS parameter 10-119 
with DD RECFM parameter 10-136 
with DD RECORG parameter 10-141 
with DD REFDD parameter 10-143 
with DD RETPD parameter 10-145 
with DD SECMODEL parameter 10-147 
with DD SPACE parameter 10-154 
with DD SPACE reclgth subparameter 10-150 
with DD STORCLAS parameter 10-156 
with DD UNIT parameter 10-173 
with DD VOLUME parameter 10-178 
with DD VOLUME=REF subparameter 10-183 
with JOBCAT DD statement 11-2 
with STEPCAT DD statement 11-8 
SMS-managed data sets 
See also SMS (Storage Management Subsystem) 
definition 10-156 
with data set password protection 10-111 
with DD MGMTCLAS parameter 10-119 
with DD STORCLAS parameter 10-156 
with DD VOLUME=REF subparameter 10-183 
with JOBCAT DD statement 11-2 
with STEPCAT DD statement 11-8 
with temporary data sets 10-83 
SN 
character set for 1403 and 3203 Model 5 10-171, 
17-63 
SNA (systems network architecture) RJE or RJP 
(remote job entry or processing) 
DD * statement 10-13 
SPACE 
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DD statement parameter 10-149 
description 10-149 
examples 10-155 
relationship to other parameters 10-154 
specifying for data sets with SMS 10-154 
specifying for mass storage volumes 10-154 
subparameters 10-150 
with DD AVGREC parameter 10-24 
space, on direct access 
request for specific tasks 
through DD SPACE parameter 10-153 
system assignment of 
through DD SPACE parameter 10-150 
spacing, in printed output 
specifying 17-21, 22-14 
SPART 
parameter of JES3 //*MAIN statement 22-37 
special DD statements 
See DD, special DD statements 
ST 


subparameter of //*MAIN PROC parameter 22-35 


STACK 
subparameter of DD DCB parameter 10-58 
STACKER 
parameter of JES3 //*FORMAT PR 
statement 22-18 
STANDARD 
subparameter of //*FORMAT CHARS 
parameter 22-13 
subparameter of //*FORMAT FLASH 
parameter 22-16 
subparameter of //*FORMAT FORMS 
parameter 22-17, 22-23 
subparameter of //*FORMAT STACKER 
parameter 22-18 
subparameter of //*FORMAT TRAIN 
parameter 22-18 
standard labels 
See SL 
See SUL 
statements 
subparameter of JOB MSGLEVEL 
parameter 15-19 
status 
coded in DD DISP parameter 10-67 
STD 
subparameter of /*JOBPARM FORMS 
parameter 21-6 
subparameter of /*OUTPUT FORMS 
parameter 21-20 
subparameter of OUTPUT JCL FCB 
parameter 17-34 
subparameter of OUTPUT JCL FLASH 
parameter 17-35 
subparameter of OUTPUT JCL FORMS 
parameter 17-40 
subparameter on OUTPUT JCL CHARS 
parameter 17-11 
STD1 
on DD FCB parameter 10-92 
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on OUTPUT JCL FCB parameter 17-33 
STD2 
on DD FCB parameter 10-92 
on OUTPUT JCL FCB parameter 17-33 
STD3 
on DD FCB parameter 10-92 
on OUTPUT JCL FCB parameter 17-33 
step 
beginning of 14-1 
definition 2-1 
maximum number 2-1 
step-level 
OUTPUT JCL statements 17-6 
STEPCAT DD statement 
description 11-8 
example 11-9 
location inJCL 11-8 
overriding JOBCAT DD statement 11-8 
parameters 11-8 
relationship to other control statements 11-8 
STEPLIB DD statement 
description 11-10 
examples 11-13 
location inJCL 11-12 
parameters 11-10 
relationship to JOBLIB_ 11-12 
relationship to other control statements 11-12 
stepname 
coding 14-1 
subparameter of EXEC COND parameter 14-10 
subparameter of JOB RESTART parameter 15-35 
stepname.ddname 
on DD statement referenced by DD DDNAME 
parameter 10-60 
subparameter of //*FORMAT DDNAME 
parameter 22-12, 22-21 
subparameter of //*MAIN SETUP 
parameter 22-36 
stepname.procstepname 
subparameter of JOB RESTART parameter 15-35 
stepname.procstepname.ddname 
subparameter of //*FORMAT DDNAME 
parameter 22-12, 22-21 
subparameter of //*MAIN SETUP 
parameter 22-36 
storage 
real (nonpageable) 
requesting forjob 15-9 
requesting for step 14-7 
virtual (pageable) 
requesting for job 15-9 
requesting for step 14-7 
storage administrator 
with DD DATACLAS parameter 10-42 
with DD MGMTCLAS parameter 10-119 
with DD STORCLAS parameter 10-156 
with DD UNIT parameter 10-173 
with DD VOLUME=SER subparameter 10-181 
storage class 
See STORCLAS 


Storage Management Subsystem (SMS) 
See SMS (Storage Management Subsystem) 
storage-class-name 
subparameter of DD STORCLAS 
parameter 10-156 
STORCLAS 
DD statement parameter 10-156 
defaults 10-157 
description 10-156 
examples 10-157 
overrides 10-157 
relationship to other parameters 10-157 
subparameters 10-156 
with DD UNIT parameter 10-173 
STRNO 
subparameter of DD AMP parameter 10-21 
SUBCHARS parameter 
processing when invalid 20-9 
XMIT JCL statement parameter 20-8 
default 20-9 
description 20-8 
example 20-9 
subparameter 20-8 
subparameter 
See also individual subparameters 
coding when multiple 3-3 
of DD DCB parameter 10-45 
syntax for 3-3 
substitute 
subparameter of XMIT JCL SUBCHARS 
parameter 20-8 
substitute characters 
with XMIT JCL statement 20-8 
SUBSYS 
DD statement parameter 10-158 
description 10-158 
examples 10-160 
relationship to other parameters 10-159 
subparameters 10-159 
subsystem-name 
subparameter of DD SUBSYS parameter 10-159 
subsystem-subparameter 
subparameter of DD SUBSYS parameter 10-159 
SUL 
subparameter of DD LABEL parameter 10-110 
symbolic 
See parameters, symbolic 
SYNAD 
subparameter of DD AMP parameter 10-21 
syntax 
for continuing statements 3-5 
format of statements 3-1 
notation for 4-1 
of parameters 4-1 
scanning forerrors 15-41 
scanning for JCL errors without execution 14-24 
SYSABEND DD statement 
description 11-14 
examples 11-16 
location in JCL 11-14 


overriding 11-16 
SYSAFF 
parameter of JES2 /*JOBPARM statement 21-7 
relationship to JOB NOTIFY parameter 15-21 
SYSALLDA 
assumed when in-stream data set referenced 10-183 
specified in DD UNIT parameter 10-174 
SYSCHK DD statement 
description 11-18 
examples 11-20 
location in JCL 11-20 
parameters 11-18 
relationship to other control statements 11-19 
SYSCKEOV DD statement 
description 11-21 
example 11-22 
location in JCL 11-22 
parameters 11-21 
relationship to DD CHKPT parameter 10-31 
SYSGROUP 
subparameter of DD MSVGP parameter 10-123 
SYSIN DD statement 
description 11-23 
examples 11-23 
location in JCL 11-23 
parameters 11-23 
SYSMDUMP DD statement 
description 11-14 
examples 11-16 
location in JCL 11-14 
overriding 11-16 
SYSMSG 
subparameter of //-FORMAT DDNAME 
parameter 22-12 
SYSOUT 
See also sysout 
DD statement parameter 10-161 
defaults 10-163 
description 10-161 
examples 10-166 
overrides 10-163 
relationship to other control statements 10-164 
relationship to other parameters 10-164 
subparameters 10-162 
relationship to DD COPIES parameter 10-37 
with DEST =(node) 10-64, 10-65 
sysout (system output data set) 
associating with an OUTPUT JCL 
statement 10-128 
references to OUTPUT JCL statements 17-6 
specifying through DD SYSOUT parameter 10-161 
SYSTEM 
parameter of JES3 //*MAIN statement 22-37 
SYSUDUMP DD statement 
description 11-14 
examples 11-16 
location in JCL 11-14 
overriding 11-16 
SYS1.PROCLIB 
use for procedures 2-] 
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subparameter of DCB EROPT parameter 10-52 
subparameter of DCB FUNC subparameter 10-52 
subparameter of DCB OPTCD subparameter 10-55 
subparameter of DCB TRTCH 
subparameter 10-58 
subparameter of RECFM parameter 10-137, 
10-138 
table reference character 
See trc 
table-name 
subparameter of //*FORMAT CHARS 
parameter 22-13 
subparameter on DD CHARS parameter 10-28 
subparameter on OUTPUT JCL CHARS 
parameter 17-11 
tasks 
charts of 2-2 
for entering jobs 
chart of 2-3 
for processing jobs 
chart of 2-6 
for requesting data set resources 
chart of 2-7 
for requesting sysout data set resources 
chart of 2-10 
introduced iii, 2-1 
TCAM (telecommunications access method) 
subparameters of DD DCB parameter 10-49 
with DD statement QNAME parameter 10-135 
tcamname 
subparameter of DD QNAME parameter 10-135 
telecommunications access method 
See TCAM (telecommunications access method) 
temporary data set 10-83 
TERM 
DD statement parameter 10-168 
description 10-168 
examples 10-169 
location in JCL 10-168 
relationship to other parameters 10-168 
subparameter 10-168 
terminals 
data coming from or going to 10-168 
termination 
abnormal 
dumps for 11-14 
normal 
dumps for 11-14 
notification of 15-21 
testing of return codes from 14-9, 15-13 
test 
of on-line terminal 10-52 
tests, return code 
specifying 14-9, 15-13 
THRESH 
subparameter of DD DCB parameter 10-58 
THRESHLD 
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OUTPUT JCL statement parameter 17-58 
defaults 17-58 
description 17-58 
example 17-59 
subparameter 17-58 
parameter of JES3 //*FORMAT PR 
statement 22-18 
THWS 
subparameter of //*MAIN SETUP 
parameter 22-36 
THWSSEP 
parameter of JES3 //*MAIN statement 22-38 
TIME 
EXEC statement parameter 14-33 
defaults 14-34 
description 14-33 
examples 14-35 
overrides 14-34 
subparameters 14-33 
JES2 format subparameter of JOB accounting 
information 15-6 
JOB statement parameter 15-38 
defaults 15-38 
description 15-38 
examples 15-39 
overrides 15-39 
subparameters 15-38 
parameter of JES2 /*JOBPARM statement 21-8 
time 
checking by system 14-34, 15-39 
handling by system 14-34, 15-39 
subparameter of //FMAIN DEADLINE 
parameter 22-29 
system conversion of time value 14-34, 15-39 
time out with EXEC COND parameter 14-12 
use of, by job 15-38 
use of, by job step 14-33 
TN 
character set for 1403 and 3203 Model 5 10-171, 
17-63 
TPROCESS macro instruction 
accessing TCAM messages 10-135 
TRACE 
subparameter of DCB DIAGNS 
subparameter 10-51 
subparameter of DD AMP parameter 10-22 
trace 
of OPEN/CLOSE/EOV 10-51 
tracks 
specifying in DD SPACE parameter 10-150 
subparameter of DCB CYLOFL 
subparameter 10-50 
subparameter of DCB LIMCT subparameter 10-53 
subparameter of DCB NCP parameter 10-54 
TRAIN 
parameter of JES3 //*FORMAT PR 
statement 22-18 
train-name 
subparameter of //*FORMAT TRAIN 
parameter 22-18 


translation, of labels 


specified by DD LABEL parameter 10-113 


transmission 


of input stream to network node 22-53 
of input stream using XMIT JCL statement 20-1 


TRC 


trc 


OUTPUT JCL statement parameter 
defaults 17-60 
description 17-60 
example 17-61 
relationship to other parameters 
subparameters 17-60 


17-60 


17-60 


subparameter of /*OUTPUT MODIFY 
parameter Z1-21 

subparameter of /*OUTPUT MODTRC 
parameter 21-21 

subparameter of //*FORMAT FORMS 
parameter 22-17 

subparameter of DD MODIFY parameter 

subparameter of OUTPUT JCL MODIFY 
parameter 17-50 


10-121 


TRIPLE 


subparameter of //*FORMAT CONTROL 
parameter 22-14 
subparameter of OUTPUT JCL CONTROL 


parameter 17-21 

TRK 

subparameter of DD SPACE parameter 10-150 
TRKGRPS 

parameter of JES3 //*MAIN statement 22-38 
TRTCH 

subparameter of DD DCB parameter 10-58 
TS 

subparameter of DD TERM parameter 10-168 
TYPE 

parameter of JES3 //*MAIN statement 22-39 


type 


subparameter of //“FORMAT DEST 
parameter 22-15, 22-23 

subparameter of //*MAIN DEADLINE 
parameter 22-29 


TYPRUN 


T11 


JOB statement parameter 15-41 
description 15-41 

example 15-42 

relationship to other control statements 


subparameters 15-41 


15-42 


character set for 3211 10-171, 17-63 


subparameter of DCB OPTCD 
subparameter 10-55, 10-56 
subparameter of DD AVGREC parameter 10-24 
subparameter of DD RECFM parameter 10-136 
subparameter of RECFM parameter 10-137, 
10-138, 10-139 


UCS 
DD statement parameter 
defaults 10-171 
description 10-170 
examples 10-172 
overrides 10-171 
relationship to other parameters 
subparameters 10-170 
OUTPUT JCL statement parameter 
defaults 17-62 
description 17-62 
example 17-64 
overrides 17-63 
subparameter 17-62 
parameter of JES2 /*OUTPUT statement 
Un 
parameter of JES2 /*ROUTE statement 
subparameter of /*OUTPUT DEST 
parameter 21-18 
subparameter of DD DEST parameter 
subparameter of OUTPUT JCL DEST 
parameter 17-31 
UNBLOCK 
subparameter of OUTPUT JCL DATACK 
parameter 17-25 
UNCATLG 
subparameter of DD DISP parameter 
UNIT 
DD statement parameter 
description 10-173 
examples 10-177 
location in JCL 
overrides 10-176 
relationship to other parameters 
subparameters 10-173 
relationship to DD COPIES parameter 
unit affinity 
specifying in AFF subparameter 10-176 
when DDNAME parameter is also coded 
unit-count 
subparameter of DD UNIT parameter 
unqualified 
See name 
UPDATE 
parameter of JES3 //*MAIN statement 
uppercase 
in syntax 4-2 
USER 
JOB statement parameter 
defaults 15-43 
description 15-43 
example 15-44 
relationship to other parameters 
parameter of JES3 //*MAIN statement 
subparameter 15-43 
user labels 
See AUL 
See SUL 
USERID 
parameter of JES3 //*NETACCT statement 


10-170 


10-172 


17-62 


21-22 


21-26 


10-64 


10-70 


10-173 


10-177 


10-176 


10-37 


10-60 


10-174 


22-39 


15-43 


15-44 
22-39 


Index 


22-46 
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userid 
data coming from or going to 10-168 
parameter of JES2 /*NOTIFY statement 21-12 
parameter of JES2 /*“ROUTE statement 21-26 
parameter of JES2 /*XMIT statement 21-36 
subparameter of /*OUTPUT DEST 
parameter 21-18 
subparameter of //*MAIN USER parameter 22-39 
subparameter of //*NETACCT USERID 
parameter 22-46 
subparameter of DD DEST parameter 10-64, 
10-65 
subparameter of JOB NOTIFY parameter 15-21 
subparameter of JOB USER parameter 15-43 
subparameter of OUTPUT JCL DEST 
parameter 17-31 


subparameter of AMP RECFM 
subparameter 10-21 
subparameter of DD DSID parameter 10-79 
subparameter of DD RECFM parameter 10-136 
subparameter of RECFM parameter 10-137, 
10-138, 10-139 
valueK 
subparameter of EXEC REGION parameter 14-31 
subparameter of JOB REGION parameter 15-34 
valueM 
subparameter of EXEC REGION parameter 14-31 
subparameter of JOB REGION parameter 15-34 
valuel 
subparameter of EXEC DPRTY parameter 14-15 
value2 
subparameter of EXEC DPRTY parameter 14-15 
VB 
subparameter of AMP RECFM 
subparameter 10-21 
subparameter of DD RECFM parameter 10-136 
VBS 
subparameter of DD RECFM parameter 10-136 
verification 
of FCB image 10-93 
of forms overlay frame 10-97, 17-36 
VERIFY 
subparameter of DD FCB parameter 10-93 
subparameter of DD UCS parameter 10-171 
VIRT 
subparameter of EXEC ADDRSPC 
parameter 14-7 
subparameter of JOB ADDRSPC parameter 15-9 
virtual storage 
See storage, virtual (pageable) 
virtual storage access method 
See VSAM (virtual storage access method) 
vmguestid 
parameter of JES2 /*ROUTE statement 21-27 
parameter of JES2 /*XEQ statement 21-33 
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parameter of JES2 /*XMIT statement 21-36 
parameter of JES3 //*FROUTE XEQ_) 22-53 
subparameter of XMIT JCL DEST parameter 20-5 
VOLUME 
DD statement parameter 10-178 
description 10-178 
examples 10-184 
in JES3 system 10-183 
overrides 10-183 
relationship to other parameters 10-183 
subparameters 10-179 
volume-count 
subparameter of DD VOLUME parameter 10-180 
volume-sequence-number 
subparameter of DD VOLUME parameter 10-180 
volumes 
nonspecific requests 
allocation of 10-152 
specifying 10-184 
volume counts for 10-180 
number of 
affect on number of devices allocated 10-175 
specifying by volume-count 
subparameter 10-180 
private 
specifying in PRIVATE subparameter 10-179 
retention 
specifying by RETAIN subparameter 10-179 
serial numbers 
specifying by SER subparameter 10-181 
VS 
subparameter of DD RECFM parameter 10-136 
VSAM (virtual storage access method) 
referenced in VOLUME= REF 
subparameters 10-182 
with DD AMP parameter 10-18 
with DD DATACLAS parameter 10-42 
with DD RECORG parameter 10-141 
VS2 
subparameter of //*MAIN TYPE parameter 22-39 


subparameter of //*MAIN BYTES 
parameter 22-27 
subparameter of //*MAIN CARDS 
parameter 22-28 
subparameter of //*MAIN LINES parameter 22-32 
subparameter of //*MAIN PAGES 
parameter 22-34 
subparameter of DCB FUNC subparameter 10-52 
subparameter of DCB OPTCD 
subparameter 10-54, 10-55, 10-56 
WARNING 
subparameter of //*MAIN BYTES 
parameter 22-27 
subparameter of //*MAIN CARDS 
parameter 22-28 


subparameter of //*MAIN LINES parameter 22-32 
subparameter of //*MAIN PAGES 
parameter 22-34 
work-station-name 
parameter of JES3 /*SIGNON statement 22-56 
WRITER 
OUTPUT JCL statement parameter 17-65 
defaults 17-65 
description 17-65 
example 17-66 
overrides 17-65 
relationship to other parameters 17-65 
subparameter 17-65 
writer-name 
starting external writer 10-165, 17-65 
subparameter of DD SYSOUT parameter 10-162 
with DEST =(node) 10-64, 10-65 
writer, external 
specifying on OUTPUT JCL statement 17-65 
specifying on sysout DD statement 10-161 
with OUTPUT JCL WRITER parameter 17-65 
with SYSOUT writer-name parameter 10-165 


subparameter of DCB FUNC subparameter 10-52 
subparameter of DCB PCI subparameter 10-56 
subparameter of LRECL parameter 10-118 


subparameter of /*FJOBPARM FORMS 
parameter 21-6 
subparameter of /*FJOBPARM ROOM 
parameter 21-7 
subparameter of /*OUTPUT CHARS 
parameter 21-16 
subparameter of /*OUTPUT FCB parameter 21-19 
subparameter of /*OUTPUT FORMS 
parameter 21-20 
subparameter of /*OUTPUT UCS parameter 21-22 
subparameter of /*XMIT DLM parameter 21-36 
subparameter of //*MAIN PROC parameter 22-35 
subparameter of DCB EROPT subparameter 10-52 
XEQ 
parameter of JES2 /*ROUTE statement 21-25 
XEQ JES2 statement 
See /*XEQ 
XMIT JCL statement 
JCL statement 20-1 
comments field 20-3 
description 20-1 
error on Statement 20-3 
examples 20-3 
location in JCL 20-3 
name field 20-2 
operation field 20-2 
parameter field 20-2 
support 20-1 
XMIT JES2 statement 
See /*XMIT 


XN 
character set for 1403 and 3203 Model 5 10-171, 
17-63 
Y 
Y 


See also YES 
subparameter of /*FJOBPARM BURST 
- parameter 21-5 
subparameter of /*JOBPARM RESTART 
parameter 21-7 
subparameter of /*OUTPUT BURST 
parameter 21-16 
subparameter of DCB OPTCD subparameter 10-56 
subparameter of DD PROTECT parameter 10-132 
YES 
subparameter of //* DATASET DDNAME 
parameter 22-6 
subparameter of //*FORMAT FORMS 
parameter 22-23 
subparameter of //*MAIN EXPDTCHK 
parameter 22-30 
subparameter of //*MAIN HOLD parameter 22-32 
subparameter of //*MAIN JOURNAL 
parameter 22-32 
subparameter of //*MAIN RINGCHK 
parameter 22-35 
subparameter of //* NET DEVRELSE 
parameter 22-43 
subparameter of //* NET OPHOLD 
parameter 22-44 
subparameter of DD BURST parameter 10-26 
subparameter of DD HOLD parameter 10-102 
subparameter of DD PROTECT parameter 10-132 
subparameter of OUTPUT JCL BURST 
parameter 17-9 
subparameter of OUTPUT JCL DEFAULT 
parameter 17-27 
subparameter of OUTPUT JCL PIMSG 
parameter 17-53 
subparameter of OUTPUT JCL TRC 
parameter 17-60 


YN 
character set for 1403 and 3203 Model 5_ 10-171, 
17-63 
yyddd 
subparameter of DD EXPDT parameter 10-90 
yyyy/ddd 


subparameter of DD EXPDT parameter 10-90 


Z 


Z 
subparameter of DCB OPTCD subparameter 10-55 


Index X-35 


subparameter of DCB PRTSP subparameter 10-57 


subparameter of DCB DEN subparameter 10-51 

subparameter of DCB PRTSP subparameter 10-57 

subparameter of DCB STACK subparameter 10-58 
1440 

subparameter of EXEC TIME parameter 14-33 

subparameter of JOB TIME parameter 15-38 


subparameter of DCB DEN subparameter 10-51 
subparameter of DCB PRTSP subparameter 10-57 
subparameter of DCB STACK subparameter 10-58 


subparameter of DCB DEN subparameter 10-51 
subparameter of DCB PRTSP subparameter 10-57 
3211 Printer with indexing feature 
specifying indexing of left margin 17-43 
specifying indexing of right margin 17-47 
3330 Disk Storage Model 11 
specifying in UNIT parameter 10-174 
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3330v 
See MSS 
3340 Direct Access Storage Facilities 
specifying in UNIT parameter 10-174 
3480 Magnetic Tape Subsystem 
specifying in UNIT parameter 10-174 
3540 diskette input/output unit 
DD * statement 10-14 
with DD DATA parameter 10-40 
with DD DCB parameter 10-47 
with DD DSID parameter 10-79 
with VOLUME=SER subparameter 10-183 
3800 Printing Subsystem 
DD BURST parameter 10-26 
DD CHARS parameter 10-28 
OUTPUT JCL BURST parameter 17-9 
OUTPUT JCL CHARS parameter 17-11 
specifying copy groups for 10-35, 17-22, 22-14 


subparameter of DCB DEN subparameter 10-51 


subparameter of //*“FORMAT CARRIAGE 
parameter 22-12 

subparameter of //*“FORMAT FCB 
parameter 22-16 
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